Clé API de test gratuite pour les fiches d’établissement
Testez l’API de fiches et MCP : accès à la journée gratuit (24 h), sans carte. Jusqu’à 2 établissements synchronisés à 10 annuaires démo uniquement.
Obtenez une clé API gratuite pour tester l’API REST de fiches d’établissement listingsAPI et le serveur MCP hébergé dans le cadre de votre intégration de référencement local, sans carte bancaire. L’accès à la journée dure 24 heures à compter de son activation et n’est proposé que pendant des périodes limitées. Vous pouvez créer jusqu’à 2 établissements, les mettre à jour et observer la synchronisation de leurs fiches avec 10 annuaires de démonstration listingsAPI inspirés de MapQuest, Apple Maps, Bing, Yelp et d’autres. Rien n’est jamais envoyé à de véritables plateformes de publication : vous pouvez donc tester l’ensemble du cycle de création, de synchronisation et de mise à jour sans toucher à une véritable fiche d’établissement.
Statut en direct : GET /api/day-pass indique si l’accès à la journée est ouvert en ce moment.
L’accès à la journée n’est proposé que pendant des périodes limitées. Lorsque les inscriptions sont fermées, le service d’inscription renvoie 403 avec sandbox_closed, et vous pouvez toujours souscrire une offre payante avec son essai gratuit de 14 jours.
Ce qui est inclus
Chaque inscription nécessite un prénom, un nom, une adresse e-mail et une entreprise, ainsi que l’acceptation des Conditions d’utilisation et de la Politique de confidentialité. Les personnes et les agents d’IA utilisent le même accès à la journée : un agent peut le démarrer pour son utilisateur, et l’utilisateur prouve que l’adresse e-mail lui appartient.
Les 24 heures commencent au démarrage de l’accès : lorsque son titulaire appuie sur Start my day pass (Démarrer mon accès à la journée) depuis le lien reçu par e-mail, ou lorsque le code à 6 chiffres reçu par e-mail est utilisé. Le lien et le code restent valables pendant 24 heures après l’inscription.
L’essai gratuit de 14 jours est différent. Il s’applique à une offre payante avec une carte bancaire enregistrée et permet de publier dans de véritables annuaires. L’accès à la journée ne nécessite aucune carte bancaire, dure une journée et permet de publier uniquement dans des annuaires de démonstration.
Démarrez votre accès dans votre navigateur
- Ouvrez la page d’inscription à l’accès à la journée et saisissez votre nom, votre adresse e-mail et votre entreprise, puis acceptez les Conditions d’utilisation et la Politique de confidentialité.
- Nous vous envoyons un lien et un code à 6 chiffres par e-mail.
- Ouvrez le lien et appuyez sur Start my day pass (Démarrer mon accès à la journée), ou saisissez le code sur la page d’inscription. Votre tableau de bord s’ouvre et affiche votre clé API.
Laissez votre agent d’IA démarrer votre accès
Collez cette instruction pour l’agent dans Claude, ChatGPT, Cursor ou tout agent capable d’effectuer des requêtes HTTP :
Read https://listingsapi.com/docs/day-pass.md and start a listingsAPI sandbox day pass for me. Ask me for my first name, last name, email and company, and confirm that I accept the Terms of Service and Privacy Policy before you sign up. Then ask me for the 6-digit code from the email, or wait while I press Start my day pass in it. With the API key, create one sample location, show me which demo directories it synced to with their links, change its opening hours, and read the listings back. Use only the day pass sandbox, and show me the integration code you used.
L’agent effectue les appels décrits dans la section suivante. Il n’a jamais besoin du tableau de bord, et la clé est transmise uniquement à l’agent qui a demandé l’accès.
Démarrez votre accès depuis votre code
L’API d’accès à la journée utilise la même origine que l’API REST, et aucun de ses appels ne nécessite de clé. Vérifiez si l’accès à la journée est disponible et consultez ses limites :
curl https://listingsapi.com/api/day-pass1. Demandez l’accès à la journée
curl -X POST https://listingsapi.com/api/day-pass/signup \ -H "Content-Type: application/json" \ -d '{ "first_name": "Ada", "last_name": "Lovelace", "email": "ada@example.com", "company": "Analytical Engines", "accept_terms": true }'Ne définissez accept_terms qu’une fois que la personne a accepté les Conditions d’utilisation et la Politique de confidentialité. La réponse est 202, et nous envoyons à la personne un lien et un code à 6 chiffres par e-mail. Pour protéger la vie privée des personnes, chaque requête autorisée reçoit la même réponse : si l’adresse e-mail est déjà associée à un compte listingsAPI ou a déjà servi à bénéficier d’un accès à la journée, nous en informons son titulaire dans cet e-mail, et la demande n’est jamais lancée.
{ "status": "verification_sent", "email": "ada@example.com", "expires_in": 86400, "poll_token": "9f2c…64 hexadecimal characters…", "poll_interval_seconds": 5, "next": { "tell_the_user": "We emailed ada@example.com a link and a 6-digit code. …", "with_code": { "method": "POST", "url": "https://listingsapi.com/api/day-pass/start" }, "or_poll": { "method": "POST", "url": "https://listingsapi.com/api/day-pass/status" } }, "docs": "https://listingsapi.com/docs/day-pass"}Gardez poll_token secret. Il associe le code et la clé à votre demande : toute personne qui le détient peut donc récupérer la clé API une fois l’accès démarré.
2. Activez-le avec le code reçu par e-mail
Demandez à la personne le code à 6 chiffres reçu par e-mail, puis envoyez-le avec poll_token :
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'Le code ne fonctionne qu'avec poll_token de la demande pour laquelle il a été envoyé par e-mail ; il ne peut donc pas être saisi sur le site web à la place.
Ou attendez que le propriétaire clique sur Start
Si la personne préfère cliquer sur Start my day pass (Activer mon accès à la journée) dans l'e-mail, interrogez le serveur avec poll_token toutes les 5 secondes :
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Tant qu'elle n'a pas cliqué dessus, la réponse est {"status": "pending"} avec un en-tête Retry-After. Ensuite, la réponse contient les mêmes identifiants que ceux renvoyés par l'appel d'activation.
Les identifiants
{ "status": "active", "api_key": "dp.…", "authorization_header": "API dp.…", "api_base_url": "https://listingsapi.com", "mcp_url": "https://listingsapi.com/mcp", "expires_at": "2026-09-26T10:04:11Z", "limits": { "locations": 2, "requests_per_minute": 30, "requests_per_day": 1500 }, "includes": ["locations", "listings"], "demo_directories": [ { "name": "MapQuest", "sync": "instant" }, { "name": "N49", "sync": "delayed" } ], "dashboard_url": "https://listingsapi.com/dashboard", "docs": "https://listingsapi.com/docs/day-pass", "next_steps": ["Create a location: POST https://listingsapi.com/api/v4/locations …"]}Les clés d'accès à la journée commencent par dp., et l'API et le serveur MCP ne les acceptent que pour les endpoints locations et listings. limits contient les valeurs actuelles de l'accès, et demo_directories répertorie les 10 annuaires. Si une réponse est perdue, répéter l'appel d'activation ou interroger à nouveau le serveur renvoie la même clé pendant 10 minutes ; passé ce délai, la demande est clôturée. Seuls les codes incorrects sont comptabilisés dans les 5 tentatives autorisées pour un code. Le propriétaire peut se connecter au tableau de bord à tout moment avec Email me a sign-in link (M'envoyer un lien de connexion par e-mail).
Erreurs
Connecter MCP
Le serveur MCP hébergé accepte la clé d'accès à la journée dans le même en-tête que l'API REST. Pour Claude Code :
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Les configurations pour Cursor, Windsurf, Codex et d'autres clients se trouvent sur la page MCP. Les clients qui se connectent avec OAuth, comme le connecteur listingsAPI dans l'annuaire de Claude ou un connecteur personnalisé Claude, ouvrent plutôt la page de connexion listingsAPI : choisissez Email me a sign-in link (M'envoyer un lien de connexion par e-mail) avec l'adresse e-mail de l'accès à la journée. Avec un accès à la journée, le serveur propose les outils locations, listings, docs et account, notamment locations_create, locations_update et listings_premium.
Trouver listingsAPI dans les annuaires d'outils d'IA
Le serveur MCP et la compétence d'agent listingsAPI sont répertoriés dans ces annuaires, afin que vous ou votre agent puissiez les installer depuis celui que votre client utilise déjà :
Ajouter les compétences d'agent
5 compétences d'agent listingsAPI sont publiées sur skills.sh. Avec un accès à la journée, listingsapi-integration et listingsapi-listing-audit conviennent : elles utilisent les établissements et les fiches inclus dans cet accès. Les compétences de gestion des avis, de publication et de création de rapports nécessitent des fonctionnalités que l'accès à la journée n'inclut pas. Installez les 2 avec Skills CLI :
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditCréer un établissement
L'adresse doit être réelle et géocodable, le numéro de téléphone doit comporter 10 chiffres et la description au moins 200 caractères. Un exemple convient, car il est uniquement transmis aux annuaires de démonstration.
curl -X POST https://listingsapi.com/api/v4/locations \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "name": "Acme Kitchen", "description": "Acme Kitchen is a family-owned neighborhood restaurant in downtown New York serving wood-fired pizza, hand-rolled pasta, and a short seasonal menu built around produce from nearby growers. Our dining room seats forty, takeout and delivery run until close.", "street": "350 5th Ave", "city": "New York", "stateIso": "NY", "postalCode": "10118", "countryIso": "US", "phone": "6443859313", "bizUrl": "https://acmekitchen.example.com", "subCategoryId": 1432 } }'La réponse contient le nouvel établissement sous data.createLocation.location. Conservez son id en base64 pour les appels ci-dessous.
Observez la synchronisation
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"Chaque enregistrement sous data.listingsForLocation contient le nom d’un annuaire de démonstration et son syncStatus. Sept annuaires affichent SYNCED en quelques secondes, avec un listingUrl qui ouvre la page de démonstration. N49, Chamber of Commerce et Hotfrog affichent d’abord IN_PROGRESS pendant 30 à 90 secondes, ce qui vous permet d’observer le changement de statut. Les pages de démonstration sont signalées comme des bacs à sable et masquées aux moteurs de recherche et aux robots d’exploration d’IA.
Modifiez un champ et vérifiez à nouveau
Envoyez uniquement les champs que vous modifiez. Pour les horaires d’ouverture, envoyez la semaine complète :
curl -X POST https://listingsapi.com/api/v4/locations/update \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "input": { "id": "<location-id>", "businessHours": [ { "day": "MONDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "TUESDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "WEDNESDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "THURSDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "FRIDAY", "type": "OPEN", "slots": [{ "start": "08:00am", "end": "06:00pm" }] }, { "day": "SATURDAY", "type": "CLOSED", "slots": [] }, { "day": "SUNDAY", "type": "CLOSED", "slots": [] } ] } }'La mise à jour renvoie le statut HTTP 200 même lorsque la validation échoue. Vérifiez donc success dans le corps de la réponse, puis consultez à nouveau les fiches premium.
Instructions pour l’agent à essayer
Une fois le serveur MCP connecté, collez l’une de ces instructions dans votre agent :
Use the listingsAPI tools to create a sample location for a coffee shop at a real street address in Austin, TX, with a 10-digit phone number, a website and a description of at least 200 characters. Then show its premium listings as a table of directory, syncStatus and listingUrl.
Show the premium listings for my listingsAPI location again. Tell me which demo directories are synced and which are still in progress, and give me the link to each demo listing page.
Update my listingsAPI location's opening hours to 8am to 6pm on weekdays and closed on weekends, sending the full seven-day week. Then check its premium listings again and tell me what changed.
Après 24 heures
La clé API cesse de fonctionner et le tableau de bord vous invite à passer à une offre supérieure. Vous disposez alors de 48 heures pour souscrire à Launch ou Growth avec la même adresse e-mail ; nous vous envoyons par e-mail un lien pour définir un mot de passe, et le compte de bac à sable est supprimé dès la création du nouveau compte. Si vous ne passez pas à une offre supérieure dans ce délai de 48 heures, le compte de bac à sable et ses données sont supprimés. Les établissements du bac à sable ne sont jamais transférés vers une offre payante.
Questions fréquentes
La clé API du bac à sable est-elle gratuite, et ai-je besoin d’une carte bancaire ?
L’accès à la journée au bac à sable est gratuit. Aucune carte bancaire ni aucun mot de passe n’est requis. Il est proposé pendant des périodes limitées ; vérifiez la disponibilité actuelle avant de vous inscrire.
Combien de temps dure l’accès à la journée ?
L’accès dure 24 heures à compter de son activation, lorsque vous cliquez sur Start my day pass (Activer mon accès à la journée) depuis le lien envoyé par e-mail ou utilisez le code à 6 chiffres envoyé par e-mail.
Que puis-je tester avec la clé API du bac à sable ?
Vous pouvez créer et mettre à jour jusqu’à 2 établissements et consulter leurs fiches via REST ou MCP. Les fiches sont synchronisées uniquement avec 10 annuaires de démonstration listingsAPI, jamais avec de véritables plateformes de publication. Les avis, les publications, les fonctionnalités sociales, les analyses, les comptes connectés, les webhooks et les établissements supplémentaires ne sont pas inclus.
Un agent IA peut-il obtenir une clé de bac à sable pour moi ?
Oui. Un agent peut demander un accès à la journée avec votre nom, votre adresse e-mail et votre entreprise après que vous avez accepté les conditions d’utilisation et la politique de confidentialité. Vous vérifiez votre adresse e-mail à l’aide du lien ou du code à 6 chiffres envoyé par e-mail, et l’agent à l’origine de la demande reçoit la clé API. Les appels d’inscription, d’activation et de consultation du statut ne nécessitent pas de clé API.
Est-ce la même chose que l’essai gratuit de 14 jours ?
Non. L’essai de 14 jours utilise une offre payante avec une carte bancaire enregistrée et permet de publier dans de véritables annuaires. L’accès à la journée ne nécessite aucune carte bancaire, dure une journée et permet de publier uniquement dans des annuaires de démonstration. Chaque adresse e-mail peut bénéficier d’un seul accès à la journée, et les clients existants de listingsAPI ne sont pas éligibles.