Chave de API gratuita de sandbox para listagens de empresas
Teste a API de listagens de empresas e servidor MCP: passe diário sandbox grátis de 24h, sem cartão. Até 2 locais, sincronizados só com 10 diretórios demo.
Obtenha uma chave de API gratuita de sandbox para testar a API REST de listagens de empresas e o servidor MCP hospedado da listingsAPI na sua integração de SEO local, sem cartão de crédito. O passe diário dura 24 horas a partir da ativação e é oferecido por períodos limitados. Você cria até 2 locais, atualiza esses locais e acompanha a sincronização das listagens com 10 diretórios de demonstração listingsAPI inspirados em MapQuest, Apple Maps, Bing, Yelp e outros. Nada é enviado às plataformas de publicação reais, então você pode testar todo o ciclo de criação, sincronização e atualização sem alterar um perfil de empresa real.
Status em tempo real: GET /api/day-pass informa se o passe diário está disponível agora.
O passe diário é oferecido por períodos limitados. Enquanto as inscrições estiverem fechadas, o cadastro retorna 403 com sandbox_closed, e você ainda pode começar com um plano pago que inclui um período de teste gratuito de 14 dias.
O que você recebe
Em cada cadastro, é necessário informar nome, sobrenome, e-mail e empresa, além de aceitar os Termos de Serviço e a Política de Privacidade. Pessoas e agentes de IA usam o mesmo passe diário: um agente pode iniciá-lo para seu usuário, e o usuário comprova que o e-mail é dele.
As 24 horas começam quando o passe é iniciado: quando o titular pressiona Start my day pass (Iniciar meu passe diário) pelo link enviado por e-mail ou quando o código de 6 dígitos enviado por e-mail é usado. O link e o código funcionam por 24 horas após o cadastro.
O período de teste gratuito de 14 dias é diferente. Ele funciona em um plano pago com um cartão cadastrado e permite publicar em diretórios reais. O passe diário não exige cartão, dura 1 dia e permite publicar apenas em diretórios de demonstração.
Inicie pelo navegador
- Abra o cadastro do passe diário e informe seu nome, e-mail e empresa, depois aceite os Termos de Serviço e a Política de Privacidade.
- Enviamos a você um e-mail com um link e um código de 6 dígitos.
- Abra o link e pressione Start my day pass (Iniciar meu passe diário), ou digite o código na página de cadastro. Seu painel será aberto com sua chave de API.
Deixe seu agente de IA iniciar o passe
Cole esta instrução para o agente no Claude, ChatGPT, Cursor ou em qualquer agente capaz de fazer requisições 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.
O agente faz as chamadas da próxima seção. Ele nunca precisa do painel, e a chave é enviada apenas ao agente que solicitou o passe.
Inicie pelo código
A API do passe diário está na mesma origem que a API REST, e nenhuma de suas chamadas exige uma chave. Verifique se as inscrições para o passe diário estão abertas e consulte os limites:
curl https://listingsapi.com/api/day-pass1. Solicite o passe diário
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 }'Defina accept_terms somente depois que a pessoa concordar com os Termos de Serviço e a Política de Privacidade. A resposta é 202, e enviamos à pessoa um e-mail com um link e um código de 6 dígitos. Para proteger a privacidade das pessoas, todas as requisições permitidas recebem a mesma resposta: se o e-mail já estiver associado a uma conta da listingsAPI ou já tiver sido usado para um passe diário, informamos isso ao titular nesse e-mail, e a solicitação nunca é iniciada.
{ "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"}Mantenha poll_token em segredo. Ele vincula o código e a chave à sua requisição, então qualquer pessoa que o tenha pode obter a chave de API assim que o passe for iniciado.
2. Inicie-o com o código enviado por email
Peça à pessoa o código de 6 dígitos recebido por email e envie-o com o poll_token:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'O código só funciona junto com o poll_token da solicitação para a qual ele foi enviado por email, portanto não pode ser inserido no site como alternativa.
Ou aguarde o proprietário clicar em Start
Se a pessoa preferir clicar em Start my day pass (iniciar meu passe diário) no email, consulte o status com o poll_token a cada 5 segundos:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Até que ela clique, a resposta será {"status": "pending"} com um cabeçalho Retry-After. Depois disso, a resposta conterá as mesmas credenciais retornadas pela chamada de início.
As credenciais
{ "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 …"]}As chaves do passe diário começam com dp., e a API e o servidor MCP as aceitam apenas para os endpoints de locais e listagens. limits contém os valores atuais do passe, e demo_directories lista todos os dez diretórios. Se uma resposta se perder, repetir a chamada de início ou consultar novamente retornará a mesma chave por 10 minutos; depois disso, a solicitação será encerrada. Apenas códigos incorretos contam para as cinco tentativas permitidas por código. O proprietário pode entrar no painel a qualquer momento com Email me a sign-in link (enviar um link de login por email).
Erros
Conecte o MCP
O servidor MCP hospedado recebe a chave do passe diário no mesmo cabeçalho que a API REST. Para o Claude Code:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"As configurações para Cursor, Windsurf, Codex e outros clientes estão na página do MCP. Clientes que fazem login com OAuth, como o conector listingsAPI no diretório do Claude ou um conector personalizado do Claude, abrem a página de login listingsAPI em vez disso: escolha Email me a sign-in link (enviar um link de login por email) com o email do passe diário. Com um passe diário, o servidor oferece as ferramentas de locais, listagens, documentação e conta, incluindo locations_create, locations_update e listings_premium.
Encontre listingsAPI em diretórios de ferramentas de IA
O servidor MCP e a habilidade listingsAPI para agentes estão listados nestes diretórios, para que você ou seu agente possam instalá-los pelo diretório que seu cliente já usa:
Adicione as habilidades para agentes
Cinco habilidades listingsAPI para agentes estão publicadas em skills.sh. Para um passe diário, listingsapi-integration e listingsapi-listing-audit são adequadas: elas usam os locais e as listagens incluídos no passe. As habilidades de avaliações, publicações e relatórios precisam de recursos que o passe diário não inclui. Instale as duas com a Skills CLI:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditCrie um local
O endereço deve ser real e permitir geocodificação, o telefone deve ser um número de 10 dígitos e a descrição deve ter pelo menos 200 caracteres. Você pode usar um exemplo, pois ele só será enviado aos diretórios de demonstração.
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 } }'A resposta contém o novo local em data.createLocation.location. Guarde o id dele em base64 para as chamadas abaixo.
Acompanhe a sincronização
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"Cada registro em data.listingsForLocation contém o nome de um diretório de demonstração e seu syncStatus. Em segundos, 7 diretórios exibem SYNCED, com um listingUrl que abre a página de demonstração. N49, Chamber of Commerce e Hotfrog exibem IN_PROGRESS inicialmente por 30 a 90 segundos, para que você possa acompanhar a mudança de status. As páginas de demonstração são identificadas como ambientes de teste e ficam ocultas dos mecanismos de busca e rastreadores de IA.
Altere um campo e verifique novamente
Envie apenas os campos que você alterar. Para os horários de funcionamento, envie a semana inteira:
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": [] } ] } }'A atualização retorna HTTP 200 mesmo quando a validação falha, portanto verifique success no corpo da resposta e, em seguida, consulte as listagens premium novamente.
Instruções para o agente que você pode testar
Com o servidor MCP conectado, cole uma destas instruções no seu agente:
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.
Após 24 horas
A chave de API deixa de funcionar e o painel solicita que você faça upgrade. Você então tem 48 horas para se cadastrar no Launch ou Growth com o mesmo e-mail; enviamos por e-mail um link para você definir uma senha, e a conta de teste é excluída assim que a nova conta é criada. Se você não fizer upgrade nessas 48 horas, a conta de teste e seus dados serão excluídos. Os locais de teste nunca são transferidos para um plano pago.
Perguntas frequentes
A chave de API de teste é gratuita? Preciso de um cartão de crédito?
O passe diário de teste é gratuito. Não é necessário cartão de crédito nem senha. Ele é oferecido por períodos limitados; verifique a disponibilidade atual antes de se cadastrar.
Quanto tempo dura o passe diário?
O passe dura 24 horas a partir da ativação, que ocorre quando você clica em Start my day pass (Iniciar meu passe diário) pelo link enviado por e-mail ou usa o código de 6 dígitos enviado por e-mail.
O que posso testar com a chave de API de teste?
Você pode criar e atualizar até 2 locais e consultar suas listagens usando REST ou MCP. As listagens são sincronizadas apenas com 10 diretórios de demonstração listingsAPI, nunca com plataformas de publicação reais. Avaliações, publicações, redes sociais, análises, contas conectadas, webhooks e locais adicionais não estão incluídos.
Um agente de IA pode obter uma chave de teste para mim?
Sim. Um agente pode solicitar um passe diário com seu nome, e-mail e empresa após você concordar com os Termos de Serviço e a Política de Privacidade. Você verifica seu e-mail usando o link ou o código de 6 dígitos enviado por e-mail, e o agente solicitante recebe a chave de API. As chamadas de cadastro, ativação e consulta de status não precisam de uma chave de API.
Isso é o mesmo que o período de teste gratuito de 14 dias?
Não. O teste de 14 dias funciona em um plano pago com um cartão cadastrado e publica em diretórios reais. O passe diário não exige cartão, dura um dia e publica apenas em diretórios de demonstração. Cada e-mail pode usar um passe diário, e clientes atuais de listingsAPI não são elegíveis.