Kostenloser Sandbox-API-Schlüssel für Unternehmenseinträge
Testen Sie Unternehmenseinträge-API und MCP-Server: gratis 24-h-Sandbox-Tagespass ohne Kreditkarte; bis zu 2 Standorte, Sync nur zu 10 Demo-Verzeichnissen.
Holen Sie sich einen kostenlosen Sandbox-API-Schlüssel, um die REST API für Unternehmenseinträge von listingsAPI und den gehosteten MCP-Server für Ihre lokale SEO-Integration zu testen, ohne Kreditkarte. Der Tagespass gilt ab Aktivierung 24 Stunden und wird für begrenzte Zeiträume angeboten. Sie erstellen bis zu 2 Standorte, aktualisieren sie und verfolgen, wie ihre Einträge mit 10 listingsAPI-Demo-Verzeichnissen synchronisiert werden, die MapQuest, Apple Maps, Bing, Yelp und anderen nachempfunden sind. Es wird niemals etwas an echte Plattformen gesendet, sodass Sie den gesamten Ablauf aus Erstellung, Synchronisierung und Aktualisierung ausprobieren können, ohne ein echtes Unternehmensprofil zu verändern.
Live-Status: GET /api/day-pass zeigt, ob der Tagespass gerade verfügbar ist.
Der Tagespass wird für begrenzte Zeiträume angeboten. Wenn das Angebot nicht verfügbar ist, gibt die Registrierung 403 mit sandbox_closed zurück, und Sie können weiterhin mit einem kostenpflichtigen Tarif und dessen 14-tägiger kostenloser Testphase starten.
Was Sie erhalten
Bei jeder Registrierung werden Vorname, Nachname, E-Mail-Adresse und Unternehmen angegeben sowie die Nutzungsbedingungen und die Datenschutzerklärung akzeptiert. Menschen und KI-Agenten nutzen denselben Tagespass: Ein Agent kann ihn für seinen Nutzer starten, und der Nutzer bestätigt, dass die E-Mail-Adresse ihm gehört.
Die 24 Stunden beginnen mit dem Start des Tagespasses: wenn der Inhaber über den per E-Mail gesendeten Link auf Start my day pass (Meinen Tagespass starten) klickt oder wenn der per E-Mail gesendete 6-stellige Code verwendet wird. Der Link und der Code sind nach der Registrierung 24 Stunden lang gültig.
Die 14-tägige kostenlose Testphase ist ein anderes Angebot. Sie läuft in einem kostenpflichtigen Tarif mit hinterlegter Kreditkarte und ermöglicht die Veröffentlichung in echten Verzeichnissen. Der Tagespass erfordert keine Kreditkarte, gilt einen Tag lang und ermöglicht die Veröffentlichung ausschließlich in Demo-Verzeichnissen.
Starten Sie ihn in Ihrem Browser
- Öffnen Sie die Registrierung für den Tagespass, geben Sie Ihren Namen, Ihre E-Mail-Adresse und Ihr Unternehmen ein und akzeptieren Sie anschließend die Nutzungsbedingungen und die Datenschutzerklärung.
- Wir senden Ihnen per E-Mail einen Link und einen 6-stelligen Code.
- Öffnen Sie den Link und klicken Sie auf Start my day pass (Meinen Tagespass starten) oder geben Sie den Code auf der Registrierungsseite ein. Ihr Dashboard mit Ihrem API-Schlüssel öffnet sich.
Lassen Sie Ihren KI-Agenten ihn starten
Fügen Sie diesen Prompt in Claude, ChatGPT, Cursor oder einen beliebigen Agenten ein, der HTTP-Anfragen senden kann:
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.
Der Agent führt die Aufrufe aus dem nächsten Abschnitt aus. Er benötigt das Dashboard zu keinem Zeitpunkt, und der Schlüssel geht ausschließlich an den Agenten, der den Tagespass angefordert hat.
Starten Sie ihn per Code
Die Tagespass-API hat denselben Origin wie die REST API, und keiner ihrer Aufrufe erfordert einen Schlüssel. Prüfen Sie, ob der Tagespass verfügbar ist, und lesen Sie die zugehörigen Limits:
curl https://listingsapi.com/api/day-pass1. Fordern Sie den Tagespass an
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 }'Setzen Sie accept_terms erst, nachdem die Person den Nutzungsbedingungen und der Datenschutzerklärung zugestimmt hat. Die Antwort lautet 202, und wir senden der Person per E-Mail einen Link und einen 6-stelligen Code. Zum Schutz der Privatsphäre erhält jede zulässige Anfrage dieselbe Antwort: Wenn für die E-Mail-Adresse bereits ein listingsAPI-Konto besteht oder der zugehörige Tagespass bereits genutzt wurde, informieren wir den Inhaber stattdessen in dieser E-Mail darüber, und die Anfrage wird niemals gestartet.
{ "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"}Halten Sie poll_token geheim. Dieser Wert verknüpft den Code und den Schlüssel mit Ihrer Anfrage, sodass jeder, der ihn besitzt, den API-Schlüssel abrufen kann, sobald der Tagespass startet.
2. Starten Sie ihn mit dem Code aus der E-Mail
Bitten Sie die Person um den 6-stelligen Code aus der E-Mail und senden Sie ihn dann zusammen mit poll_token:
curl -X POST https://listingsapi.com/api/day-pass/start \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>", "code": "482913" }'Der Code funktioniert nur zusammen mit poll_token der Anfrage, für die er per E-Mail versendet wurde. Deshalb kann er nicht stattdessen auf der Website eingegeben werden.
Oder warten Sie, bis der Inhaber auf Start klickt
Wenn die Person lieber in der E-Mail auf Start my day pass (Meinen Tagespass starten) klicken möchte, fragen Sie den Status alle 5 Sekunden mit poll_token ab:
curl -X POST https://listingsapi.com/api/day-pass/status \ -H "Content-Type: application/json" \ -d '{ "poll_token": "<poll_token>" }'Bis die Person darauf klickt, lautet die Antwort {"status": "pending"} mit einem Retry-After-Header. Danach enthält sie dieselben Zugangsdaten, die der Startaufruf zurückgibt.
Die Zugangsdaten
{ "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 …"]}Tagespass-Schlüssel beginnen mit dp., und die API und der MCP-Server akzeptieren sie nur für die Endpunkte locations und listings. limits enthält die aktuellen Werte des Tagespasses, und demo_directories listet alle zehn Verzeichnisse auf. Wenn eine Antwort verloren geht, erhalten Sie bei einer Wiederholung des Startaufrufs oder einer erneuten Statusabfrage 10 Minuten lang denselben Schlüssel; danach wird die Anfrage geschlossen. Nur falsche Codes zählen zu den fünf Versuchen, die ein Code zulässt. Der Inhaber kann sich jederzeit über Email me a sign-in link (Anmeldelink per E-Mail senden) beim Dashboard anmelden.
Fehler
MCP verbinden
Der gehostete MCP-Server akzeptiert den Tagespass-Schlüssel im selben Header wie die REST API. Für Claude Code:
claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <api_key>"Konfigurationen für Cursor, Windsurf, Codex und andere Clients finden Sie auf der MCP-Seite. Clients, die sich über OAuth anmelden, beispielsweise der listingsAPI-Connector im Verzeichnis von Claude oder ein benutzerdefinierter Claude-Connector, öffnen stattdessen die Anmeldeseite von listingsAPI: Wählen Sie Email me a sign-in link (Anmeldelink per E-Mail senden) und verwenden Sie dabei die E-Mail-Adresse des Tagespasses. Mit einem Tagespass bietet der Server die Tools für locations, listings, docs und account an, darunter locations_create, locations_update und listings_premium.
listingsAPI in Verzeichnissen für KI-Tools finden
Der MCP-Server und der Agent-Skill listingsAPI sind in diesen Verzeichnissen aufgeführt, sodass Sie oder Ihr Agent sie aus dem Verzeichnis installieren können, das Ihr Client bereits verwendet:
Agent-Skills hinzufügen
Fünf Agent-Skills für listingsAPI sind auf skills.sh veröffentlicht. Für einen Tagespass eignen sich listingsapi-integration und listingsapi-listing-audit: Sie verwenden die Standorte und Einträge, die der Tagespass umfasst. Die Skills für Bewertungen, Beiträge und Berichte benötigen Funktionen, die der Tagespass nicht umfasst. Installieren Sie die beiden mit der Skills CLI:
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-auditEinen Standort erstellen
Die Adresse muss real und geokodierbar sein, die Telefonnummer muss 10 Stellen haben und die Beschreibung mindestens 200 Zeichen lang sein. Ein Beispiel ist in Ordnung, da es nur an die Demo-Verzeichnisse übermittelt wird.
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 } }'Die Antwort enthält den neuen Standort unter data.createLocation.location. Bewahren Sie dessen base64-kodierte id für die folgenden Aufrufe auf.
Verfolgen Sie die Synchronisierung
curl "https://listingsapi.com/api/v4/locations/<location-id>/listings/premium" \ -H "Authorization: API $LISTINGSAPI_KEY"Jeder Datensatz unter data.listingsForLocation enthält den Namen eines Demo-Verzeichnisses und dessen syncStatus. Sieben Verzeichnisse zeigen innerhalb von Sekunden SYNCED an, zusammen mit einem listingUrl, der die Demo-Seite öffnet. N49, Chamber of Commerce und Hotfrog zeigen zunächst 30 bis 90 Sekunden lang IN_PROGRESS an, damit Sie den Statuswechsel verfolgen können. Die Demo-Seiten sind als Sandboxes gekennzeichnet und vor Suchmaschinen und KI-Crawlern verborgen.
Ändern Sie ein Feld und prüfen Sie erneut
Senden Sie nur die Felder, die Sie ändern. Senden Sie bei Öffnungszeiten die vollständige Woche:
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": [] } ] } }'Die Aktualisierung gibt auch dann HTTP 200 zurück, wenn die Validierung fehlschlägt. Prüfen Sie daher success im Antworttext und rufen Sie anschließend die Premium-Einträge erneut ab.
Prompts zum Ausprobieren
Wenn der MCP-Server verbunden ist, fügen Sie einen dieser Prompts in Ihren Agenten ein:
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.
Nach 24 Stunden
Der API-Schlüssel funktioniert nicht mehr, und das Dashboard fordert Sie zu einem Upgrade auf. Sie haben dann 48 Stunden Zeit, sich mit derselben E-Mail-Adresse für Launch oder Growth zu registrieren; wir senden Ihnen per E-Mail einen Link zum Festlegen eines Passworts, und das Sandbox-Konto wird gelöscht, sobald das neue Konto erstellt ist. Wenn Sie innerhalb dieser 48 Stunden kein Upgrade durchführen, werden das Sandbox-Konto und seine Daten gelöscht. Sandbox-Standorte werden niemals in einen kostenpflichtigen Tarif übernommen.
Häufig gestellte Fragen
Ist der Sandbox-API-Schlüssel kostenlos, und benötige ich eine Kreditkarte?
Der Sandbox-Tagespass ist kostenlos. Weder eine Kreditkarte noch ein Passwort ist erforderlich. Er wird für begrenzte Zeiträume angeboten; prüfen Sie vor der Registrierung die aktuelle Verfügbarkeit.
Wie lange gilt der Tagespass?
Der Tagespass gilt ab der Aktivierung 24 Stunden lang. Die Aktivierung erfolgt, wenn Sie über den per E-Mail gesendeten Link auf Start my day pass (Meinen Tagespass starten) klicken oder den per E-Mail gesendeten 6-stelligen Code verwenden.
Was kann ich mit dem Sandbox-API-Schlüssel testen?
Sie können bis zu 2 Standorte erstellen und aktualisieren und deren Einträge über REST oder MCP abrufen. Einträge werden ausschließlich mit 10 listingsAPI Demo-Verzeichnissen synchronisiert, niemals mit echten Plattformen. Bewertungen, Beiträge, soziale Medien, Analysen, verbundene Konten, Webhooks und zusätzliche Standorte sind nicht enthalten.
Kann ein KI-Agent einen Sandbox-Schlüssel für mich anfordern?
Ja. Ein Agent kann mit Ihrem Namen, Ihrer E-Mail-Adresse und Ihrem Unternehmen einen Tagespass anfordern, nachdem Sie den Nutzungsbedingungen und der Datenschutzerklärung zugestimmt haben. Sie bestätigen Ihre E-Mail-Adresse über den per E-Mail gesendeten Link oder den 6-stelligen Code, und der anfordernde Agent erhält den API-Schlüssel. Die Aufrufe für Registrierung, Start und Status benötigen keinen API-Schlüssel.
Ist das dasselbe wie die kostenlose 14-tägige Testphase?
Nein. Die 14-tägige Testphase läuft in einem kostenpflichtigen Tarif mit einer hinterlegten Kreditkarte und veröffentlicht Einträge in echten Verzeichnissen. Der Tagespass erfordert keine Kreditkarte, gilt einen Tag lang und veröffentlicht Einträge ausschließlich in Demo-Verzeichnissen. Jede E-Mail-Adresse kann einen Tagespass nutzen, und bestehende Kunden von listingsAPI sind nicht teilnahmeberechtigt.