Chiave API sandbox gratuita per le schede aziendali
Prova API schede aziendali e server MCP: pass giornaliero sandbox gratis, 24h, senza carta di credito. Max 2 sedi sincronizzate solo su 10 directory demo.
Ottieni una chiave API sandbox gratuita per provare l'API REST per le schede aziendali e il server MCP ospitato di listingsAPI per la tua integrazione SEO locale, senza carta di credito. Il pass giornaliero dura 24 ore dall'attivazione ed è offerto per periodi limitati. Puoi creare fino a 2 sedi, aggiornarle e osservare la sincronizzazione delle loro schede con 10 directory dimostrative listingsAPI ispirate a MapQuest, Apple Maps, Bing, Yelp e altre. Non viene mai inviato nulla alle piattaforme di pubblicazione reali, quindi puoi provare l'intero ciclo di creazione, sincronizzazione e aggiornamento senza modificare un profilo aziendale reale.
Stato in tempo reale: GET /api/day-pass indica se il pass giornaliero è disponibile in questo momento.
Il pass giornaliero è offerto per periodi limitati. Quando non è disponibile, la registrazione restituisce 403 con sandbox_closed e puoi comunque iniziare con un piano a pagamento che include una prova gratuita di 14 giorni.
Cosa ottieni
A ogni registrazione, chi si iscrive fornisce nome, cognome, email e azienda e accetta i Termini di servizio e l'Informativa sulla privacy. Persone e agenti IA usano lo stesso pass giornaliero: un agente può avviarlo per il proprio utente e l'utente dimostra che l'indirizzo email gli appartiene.
Le 24 ore decorrono dall'attivazione del pass: quando il titolare preme Start my day pass (Avvia il mio pass giornaliero) dal link ricevuto via email oppure quando viene usato il codice a 6 cifre ricevuto via email. Il link e il codice funzionano per 24 ore dopo la registrazione.
La prova gratuita di 14 giorni è diversa. Si svolge su un piano a pagamento con una carta registrata e consente di pubblicare su directory reali. Il pass giornaliero non richiede una carta, dura un giorno e consente di pubblicare solo su directory dimostrative.
Attivalo nel browser
- Apri la pagina di registrazione al pass giornaliero e inserisci il tuo nome, la tua email e la tua azienda, quindi accetta i Termini di servizio e l'Informativa sulla privacy.
- Ti inviamo via email un link e un codice a 6 cifre.
- Apri il link e premi Start my day pass (Avvia il mio pass giornaliero), oppure digita il codice nella pagina di registrazione. Si apre la tua dashboard con la tua chiave API.
Lascia che il tuo agente IA lo attivi
Incolla questo prompt in Claude, ChatGPT, Cursor o qualsiasi agente in grado di effettuare richieste 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'agente effettua le chiamate descritte nella sezione successiva. Non ha mai bisogno della dashboard e la chiave viene fornita solo all'agente che ha richiesto il pass.
Attivalo tramite codice
L'API del pass giornaliero si trova sulla stessa origine dell'API REST e nessuna delle sue chiamate richiede una chiave. Verifica se il pass giornaliero è disponibile e consulta i suoi limiti:
curl https://listingsapi.com/api/day-pass1. Richiedi il pass giornaliero
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 }'Imposta accept_terms solo dopo che la persona ha accettato i Termini di servizio e l'Informativa sulla privacy. La risposta è 202 e inviamo alla persona un'email con un link e un codice a 6 cifre. Per tutelare la privacy delle persone, ogni richiesta consentita riceve la stessa risposta: se l'indirizzo email è già associato a un account listingsAPI o ha già usufruito del pass giornaliero, informiamo il titolare tramite quell'email e la richiesta non viene mai avviata.
{ "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"}Mantieni segreto poll_token. Collega il codice e la chiave alla tua richiesta, quindi chiunque ne sia in possesso può recuperare la chiave API una volta attivato il pass.
2. Attivalo con il codice ricevuto via email
Chiedi alla persona il codice di 6 cifre ricevuto via email, poi invialo insieme al poll_token:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'Il codice funziona solo insieme al poll_token della richiesta per cui è stato inviato via email, quindi non può essere inserito sul sito web in alternativa.
Oppure attendi che il titolare prema Start
Se la persona preferisce premere Start my day pass (Attiva il mio pass giornaliero) nell'email, esegui il polling con il poll_token ogni 5 secondi:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Finché non lo preme, la risposta è {"status": "pending"} con un header Retry-After. Dopodiché, la risposta contiene le stesse credenziali restituite dalla chiamata di attivazione.
Le credenziali
{ "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 …"]}Le chiavi del pass giornaliero iniziano con dp. e l'API e il server MCP le accettano solo per gli endpoint locations e listings. limits contiene i valori correnti del pass e demo_directories elenca tutte e 10 le directory. Se una risposta va persa, ripetere la chiamata di attivazione o eseguire nuovamente il polling restituisce la stessa chiave per 10 minuti; trascorso questo intervallo, la richiesta viene chiusa. Solo i codici errati vengono conteggiati nei 5 tentativi consentiti per un codice. Il titolare può accedere alla dashboard in qualsiasi momento con Email me a sign-in link (Inviami un link di accesso via email).
Errori
Collega MCP
Il server MCP ospitato accetta la chiave del pass giornaliero nello stesso header dell'API REST. Per Claude Code:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Le configurazioni per Cursor, Windsurf, Codex e altri client si trovano nella pagina MCP. I client che effettuano l'accesso con OAuth, come il connettore listingsAPI nella directory di Claude o un connettore personalizzato di Claude, aprono invece la pagina di accesso listingsAPI: scegli Email me a sign-in link (Inviami un link di accesso via email) usando l'indirizzo email del pass giornaliero. Con un pass giornaliero, il server offre gli strumenti locations, listings, docs e account, inclusi locations_create, locations_update e listings_premium.
Trova listingsAPI nelle directory di strumenti di IA
Il server MCP e la skill listingsAPI per agenti sono presenti in queste directory, così tu o il tuo agente potete installarli da quella già utilizzata dal tuo client:
Aggiungi le skill per agenti
5 skill listingsAPI per agenti sono pubblicate su skills.sh. Con un pass giornaliero, listingsapi-integration e listingsapi-listing-audit sono adatte: usano le sedi e le schede incluse nel pass. Le skill per recensioni, pubblicazione di post e report richiedono funzionalità che il pass giornaliero non include. Installa queste 2 skill con la Skills CLI:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditCrea una sede
L'indirizzo deve essere reale e geocodificabile, il numero di telefono deve avere 10 cifre e la descrizione deve contenere almeno 200 caratteri. Un esempio va bene, perché viene inviato solo alle directory demo.
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 risposta contiene la nuova sede sotto data.createLocation.location. Conserva il suo id in base64 per le chiamate seguenti.
Osserva la sincronizzazione
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"Ogni record in data.listingsForLocation contiene il nome di una directory demo e il relativo syncStatus. Sette directory mostrano SYNCED entro pochi secondi, con un listingUrl che apre la pagina demo. N49, Chamber of Commerce e Hotfrog mostrano inizialmente IN_PROGRESS per un periodo compreso tra 30 e 90 secondi, così puoi osservare il cambiamento di stato. Le pagine demo sono contrassegnate come sandbox e nascoste ai motori di ricerca e ai crawler di IA.
Modifica un campo e controlla di nuovo
Invia solo i campi che modifichi. Per gli orari di apertura, invia l'intera settimana:
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": [] } ] } }'L'aggiornamento restituisce HTTP 200 anche quando la validazione fallisce, quindi controlla success nel corpo della risposta, poi leggi di nuovo le schede premium.
Prompt da provare
Con il server MCP connesso, incolla uno di questi prompt nel tuo 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.
Dopo 24 ore
La chiave API smette di funzionare e la dashboard ti chiede di passare a un piano a pagamento. Da quel momento hai 48 ore per iscriverti a Launch o Growth con lo stesso indirizzo email; ti inviamo via email un link per impostare una password e l'account sandbox viene eliminato non appena viene creato il nuovo account. Se non passi a un piano a pagamento entro quelle 48 ore, l'account sandbox e i suoi dati vengono eliminati. Le sedi sandbox non vengono mai trasferite a un piano a pagamento.
Domande frequenti
La chiave API sandbox è gratuita e mi serve una carta di credito?
Il pass giornaliero sandbox è gratuito. Non sono richieste né una carta di credito né una password. È disponibile per periodi limitati; controlla la disponibilità attuale prima di iscriverti.
Quanto dura il pass giornaliero?
Il pass dura 24 ore dall'attivazione, che avviene quando premi Start my day pass (Attiva il mio pass giornaliero) dal link ricevuto via email oppure usi il codice a 6 cifre ricevuto via email.
Cosa posso testare con la chiave API sandbox?
Puoi creare e aggiornare fino a 2 sedi e leggere le relative schede tramite REST o MCP. Le schede vengono sincronizzate solo con 10 directory demo listingsAPI, mai con piattaforme di pubblicazione reali. Recensioni, post, social, analisi, account collegati, webhook e sedi aggiuntive non sono inclusi.
Un agente di IA può ottenere una chiave sandbox per me?
Sì. Un agente può richiedere un pass giornaliero con il tuo nome, il tuo indirizzo email e la tua azienda dopo che hai accettato i Termini di servizio e l'Informativa sulla privacy. Verifichi il tuo indirizzo email usando il link o il codice a 6 cifre ricevuti via email e l'agente che ha effettuato la richiesta riceve la chiave API. Le chiamate di registrazione, avvio e verifica dello stato non richiedono una chiave API.
È la stessa cosa della prova gratuita di 14 giorni?
No. La prova di 14 giorni si svolge su un piano a pagamento con una carta registrata e pubblica su directory reali. Il pass giornaliero non richiede una carta, dura un giorno e pubblica solo su directory demo. Ogni indirizzo email può utilizzare un solo pass giornaliero e i clienti esistenti di listingsAPI non possono usufruirne.