Clave de API gratuita de sandbox para fichas de empresas
Prueba la API de fichas de empresas y MCP: pase de un día de sandbox gratis, sin tarjeta. Hasta 2 ubicaciones, sincronizadas solo con 10 directorios demo.
Obtén una clave de API gratuita de sandbox para probar la API REST de fichas de empresas de listingsAPI y el servidor MCP alojado para tu integración de SEO local, sin tarjeta de crédito. El pase de un día dura 24 horas desde su activación y se ofrece durante períodos limitados. Puedes crear hasta 2 ubicaciones, actualizarlas y observar cómo sus fichas se sincronizan con 10 directorios de demostración de listingsAPI inspirados en MapQuest, Apple Maps, Bing, Yelp y otros. Nunca se envía nada a plataformas de publicación reales, por lo que puedes probar todo el ciclo de creación, sincronización y actualización sin modificar un perfil de empresa real.
Estado en tiempo real: GET /api/day-pass indica si el pase de un día está disponible ahora mismo.
El pase de un día se ofrece durante períodos limitados. Mientras no esté disponible, el registro devuelve 403 con sandbox_closed, y puedes empezar igualmente con un plan de pago y su prueba gratuita de 14 días.
Qué incluye
En cada registro se proporcionan el nombre, los apellidos, el correo electrónico y la empresa, y se aceptan los Términos de servicio y la Política de privacidad. Las personas y los agentes de IA utilizan el mismo pase de un día: un agente puede iniciarlo para su usuario, y el usuario demuestra que la dirección de correo electrónico le pertenece.
Las 24 horas comienzan cuando se inicia el pase: cuando su titular pulsa Start my day pass (Iniciar mi pase de un día) desde el enlace enviado por correo electrónico, o cuando se utiliza el código de 6 dígitos enviado por correo electrónico. El enlace y el código funcionan durante las 24 horas posteriores al registro.
La prueba gratuita de 14 días es diferente. Se realiza con un plan de pago que requiere una tarjeta registrada y permite publicar en directorios reales. El pase de un día no requiere tarjeta, dura un día y permite publicar únicamente en directorios de demostración.
Inícialo en tu navegador
- Abre el registro para el pase de un día e introduce tu nombre, correo electrónico y empresa; después, acepta los Términos de servicio y la Política de privacidad.
- Te enviamos un enlace y un código de 6 dígitos por correo electrónico.
- Abre el enlace y pulsa Start my day pass (Iniciar mi pase de un día), o introduce el código en la página de registro. Se abrirá tu panel con tu clave de API.
Deja que tu agente de IA lo inicie
Pega esta instrucción para el agente en Claude, ChatGPT, Cursor o cualquier agente que pueda realizar solicitudes 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.
El agente realiza las llamadas de la siguiente sección. Nunca necesita el panel, y la clave se entrega únicamente al agente que solicitó el pase.
Inícialo desde el código
La API del pase de un día está en el mismo origen que la API REST, y ninguna de sus llamadas necesita una clave. Comprueba si el pase de un día está disponible y consulta sus límites:
curl https://listingsapi.com/api/day-pass1. Solicita el pase de un día
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 }'Establece accept_terms solo cuando la persona haya aceptado los Términos de servicio y la Política de privacidad. La respuesta es 202, y enviamos a la persona un enlace y un código de 6 dígitos por correo electrónico. Para proteger la privacidad de las personas, todas las solicitudes permitidas reciben la misma respuesta: si la dirección de correo electrónico ya tiene una cuenta de listingsAPI o ya ha utilizado su pase de un día, se lo comunicamos a su titular en ese correo electrónico, y la solicitud nunca se inicia.
{ "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"}Mantén poll_token en secreto. Vincula el código y la clave a tu solicitud, por lo que quien lo tenga puede obtener la clave de API una vez que se inicie el pase.
2. Inícialo con el código enviado por correo electrónico
Pide a la persona el código de 6 dígitos del correo electrónico y luego envíalo junto con el poll_token:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'El código solo funciona junto con el poll_token de la solicitud para la que se envió por correo electrónico, así que no se puede introducir en el sitio web en su lugar.
O espera a que el propietario pulse Iniciar
Si la persona prefiere pulsar Start my day pass (Iniciar mi pase de un día) en el correo electrónico, consulta con el poll_token cada 5 segundos:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Hasta que lo pulse, la respuesta es {"status": "pending"} con un encabezado Retry-After. Después, la respuesta contiene las mismas credenciales que devuelve la llamada de inicio.
Las credenciales
{ "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 …"]}Las claves del pase de un día empiezan por dp., y la API y el servidor MCP solo las aceptan para los endpoints de locations y listings. limits contiene los valores actuales del pase y demo_directories enumera los 10 directorios. Si se pierde una respuesta, volver a intentar la llamada de inicio o consultar de nuevo devuelve la misma clave durante 10 minutos; después, la solicitud se cierra. Solo los códigos incorrectos cuentan para el límite de 5 intentos que permite un código. El propietario puede iniciar sesión en el panel en cualquier momento con Email me a sign-in link (Enviarme un enlace de inicio de sesión por correo electrónico).
Errores
Conecta MCP
El servidor MCP alojado recibe la clave del pase de un día en el mismo encabezado que la API REST. Para Claude Code:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Las configuraciones para Cursor, Windsurf, Codex y otros clientes están en la página de MCP. Los clientes que inician sesión con OAuth, como el conector listingsAPI del directorio de Claude o un conector personalizado de Claude, abren en su lugar la página de inicio de sesión de listingsAPI: elige Email me a sign-in link (Enviarme un enlace de inicio de sesión por correo electrónico) con la dirección de correo electrónico del pase de un día. Con un pase de un día, el servidor ofrece las herramientas de locations, listings, docs y account, incluidas locations_create, locations_update y listings_premium.
Encuentra listingsAPI en los directorios de herramientas de IA
El servidor MCP y la habilidad para agentes listingsAPI figuran en estos directorios, para que tú o tu agente podáis instalarlos desde el que ya usa tu cliente:
Añade las habilidades para agentes
Hay 5 habilidades para agentes de listingsAPI publicadas en skills.sh. Para un pase de un día, listingsapi-integration y listingsapi-listing-audit son adecuadas: usan las ubicaciones y las fichas que incluye el pase. Las habilidades de reseñas, publicación e informes necesitan funciones que el pase de un día no incluye. Instala las dos con la CLI de Skills:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditCrea una ubicación
La dirección debe ser real y geocodificable, el teléfono debe ser un número de 10 dígitos y la descripción debe tener al menos 200 caracteres. Puedes usar un ejemplo, porque solo llega a los directorios de demostración.
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 respuesta contiene la nueva ubicación en data.createLocation.location. Guarda su id en base64 para las llamadas siguientes.
Observa la sincronización
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"Cada registro de data.listingsForLocation contiene el nombre de un directorio de demostración y su syncStatus. Siete directorios muestran SYNCED en cuestión de segundos, con un listingUrl que abre la página de demostración. N49, Chamber of Commerce y Hotfrog muestran primero IN_PROGRESS durante 30 a 90 segundos, para que puedas observar cómo cambia el estado. Las páginas de demostración están etiquetadas como entornos de pruebas y ocultas a los motores de búsqueda y a los rastreadores de IA.
Cambia un campo y vuelve a comprobarlo
Envía solo los campos que cambies. Para el horario de apertura, envía la semana completa:
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 actualización devuelve HTTP 200 incluso cuando falla la validación, así que comprueba success en el cuerpo de la respuesta y luego vuelve a consultar las fichas premium.
Instrucciones para el agente que puedes probar
Con el servidor MCP conectado, envía a tu agente una de estas instrucciones:
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.
Después de 24 horas
La clave de API deja de funcionar y el panel te pide que cambies a un plan de pago. A partir de ese momento, tienes 48 horas para registrarte en Launch o Growth con el mismo correo electrónico; te enviamos por correo electrónico un enlace para establecer una contraseña, y la cuenta del entorno de pruebas se elimina en cuanto se crea la nueva cuenta. Si no cambias a un plan de pago dentro de esas 48 horas, se eliminan la cuenta del entorno de pruebas y sus datos. Las ubicaciones del entorno de pruebas nunca se transfieren a un plan de pago.
Preguntas frecuentes
¿La clave de API del entorno de pruebas es gratuita y necesito una tarjeta de crédito?
El pase de un día para el entorno de pruebas es gratuito. No se requiere tarjeta de crédito ni contraseña. Se ofrece durante períodos limitados; consulta la disponibilidad actual antes de registrarte.
¿Cuánto dura el pase de un día?
El pase dura 24 horas desde su activación, que se produce cuando pulsas Start my day pass (Iniciar mi pase de un día) desde el enlace enviado por correo electrónico o usas el código de 6 dígitos enviado por correo electrónico.
¿Qué puedo probar con la clave de API del entorno de pruebas?
Puedes crear y actualizar hasta 2 ubicaciones y consultar sus fichas mediante REST o MCP. Las fichas solo se sincronizan con 10 directorios de demostración de listingsAPI, nunca con plataformas de publicación reales. No se incluyen reseñas, publicaciones, redes sociales, analítica, cuentas conectadas, webhooks ni ubicaciones adicionales.
¿Puede un agente de IA obtener una clave del entorno de pruebas por mí?
Sí. Un agente puede solicitar un pase de un día con tu nombre, correo electrónico y empresa después de que aceptes los Términos del servicio y la Política de privacidad. Verificas tu correo electrónico mediante el enlace o el código de 6 dígitos enviados por correo electrónico, y el agente que hizo la solicitud recibe la clave de API. Las llamadas de registro, inicio y estado no necesitan una clave de API.
¿Es lo mismo que la prueba gratuita de 14 días?
No. La prueba de 14 días se realiza en un plan de pago con una tarjeta registrada y publica en directorios reales. El pase de un día no necesita tarjeta, dura un día y publica solo en directorios de demostración. Cada dirección de correo electrónico puede usar un solo pase de un día, y los clientes actuales de listingsAPI no pueden acceder a él.