Kostenloser Sandbox-API-Schlüssel für Unternehmenseinträge

Firmeneintrags-API und MCP-Server gratis per 24-h-Sandbox-Tagespass testen. Keine Kreditkarte. Bis zu 2 Standorte, Abgleich nur mit 10 Demo-Verzeichnissen.

Mit einem kostenlosen Sandbox-API-Schlüssel können Sie die REST API für Unternehmenseinträge und den gehosteten MCP-Server von listingsAPI für Ihre lokale SEO-Integration testen, ohne eine Kreditkarte anzugeben. Der Tagespass gilt ab der Aktivierung 24 Stunden und wird nur in begrenzten Zeiträumen angeboten. Sie können bis zu zwei Standorte erstellen, sie aktualisieren und beobachten, wie ihre Einträge mit zehn 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 Erstellen, Synchronisieren und Aktualisieren testen 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 nur in begrenzten Zeiträumen angeboten. Außerhalb dieser Zeiträume gibt die Registrierung 403 mit sandbox_closed zurück, und Sie können weiterhin mit einem kostenpflichtigen Tarif und dessen kostenloser 14-tägiger Testphase beginnen.

Leistungsumfang

FunktionTagespass
PreisKostenlos. Keine Kreditkarte und kein Passwort erforderlich.
Dauer24 Stunden ab dem Start des Tagespasses.
StandorteBis zu 2.
EndpunkteStandorte und Einträge, ausgenommen listings scans, über REST und MCP.
VeröffentlichungNur 10 listingsAPI Demo-Verzeichnisse.
Nicht enthaltenListings scans, Bewertungen, Beiträge, Social, Analysen, verbundene Konten, Webhooks und zusätzliche Standorte.
Wer ihn nutzen kannEin Tagespass pro E-Mail-Adresse für Personen, die noch keine Kunden von listingsAPI sind.

Bei jeder Registrierung werden Vorname, Nachname, E-Mail-Adresse und Unternehmen angegeben sowie die Nutzungsbedingungen und die Datenschutzrichtlinie akzeptiert. Personen 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 kostenlose 14-tägige Testphase unterscheidet sich davon. Sie läuft im Rahmen eines kostenpflichtigen Tarifs mit einer hinterlegten Kreditkarte und ermöglicht die Veröffentlichung in echten Verzeichnissen. Der Tagespass erfordert keine Kreditkarte, gilt einen Tag und ermöglicht die Veröffentlichung ausschließlich in Demo-Verzeichnissen.

Im Browser starten

  1. Ö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 Datenschutzrichtlinie.
  2. Wir senden Ihnen einen Link und einen 6-stelligen Code per E-Mail.
  3. Ö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 wird geöffnet.

Durch Ihren KI-Agenten starten lassen

Fügen Sie diesen Prompt in Claude, ChatGPT, Cursor oder einen beliebigen Agenten ein, der HTTP-Anfragen senden kann:

Einen Tagespass mit Ihrem Agenten starten

Read https://listingsapi.com/sandbox.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 im nächsten Abschnitt aus. Er benötigt zu keinem Zeitpunkt das Dashboard, und der Schlüssel wird ausschließlich an den Agenten übermittelt, der den Tagespass angefordert hat.

Per Code starten

Die API für den Tagespass verwendet denselben Origin wie die REST API, und keiner ihrer Aufrufe erfordert einen Schlüssel. Prüfen Sie, ob der Tagespass verfügbar ist, und rufen Sie seine Limits ab:

Request
curl https://listingsapi.com/api/day-pass

1. Tagespass anfordern

Request
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 Datenschutzrichtlinie zugestimmt hat. Die Antwort lautet 202, und wir senden der Person einen Link und einen 6-stelligen Code per E-Mail. Zum Schutz der Privatsphäre erhält jede zulässige Anfrage dieselbe Antwort: Wenn für die E-Mail-Adresse bereits ein Konto bei listingsAPI besteht oder der zugehörige Tagespass bereits genutzt wurde, informieren wir stattdessen den Inhaber in dieser E-Mail darüber, und die Anfrage wird nie gestartet.

JSON
{  "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/sandbox"}

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:

Request
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 aus der Anfrage, für die er per E-Mail gesendet wurde, und kann daher 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) klickt, fragen Sie den Status alle 5 Sekunden mit poll_token ab:

Request
curl -X POST https://listingsapi.com/api/day-pass/status \  -H "Content-Type: application/json" \  -d '{ "poll_token": "<poll_token>" }'

Bis sie darauf klickt, lautet die Antwort {"status": "pending"} mit einem Retry-After-Header. Danach enthält die Antwort dieselben Zugangsdaten, die der Startaufruf zurückgibt.

Die Zugangsdaten

JSON
{  "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/sandbox",  "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 für Standorte und Einträge, mit Ausnahme von listings scans. limits enthält die aktuellen Werte des Tagespasses, und demo_directories führt alle 10 Verzeichnisse auf. Wenn eine Antwort verloren geht, erhalten Sie durch Wiederholen des Startaufrufs oder erneutes Abfragen 10 Minuten lang denselben Schlüssel; danach wird die Anfrage geschlossen. Nur falsche Codes zählen zu den 5 Versuchen, die für einen Code zulässig sind. Der Inhaber kann sich jederzeit über Email me a sign-in link (Anmeldelink per E-Mail senden) beim Dashboard anmelden.

Fehler

StatuserrorVorgehen
400invalid_requestKorrigieren Sie die in issues aufgeführten Felder.
403sandbox_closedDer Tagespass ist derzeit nicht verfügbar.
409sandbox_already_usedBeim Start: Für diese E-Mail-Adresse wurde bereits ein Tagespass genutzt.
409email_in_useBeim Start: Für diese E-Mail-Adresse besteht bereits ein listingsAPI-Tarif. Melden Sie sich stattdessen an.
410code_expired oder poll_token_expiredDie Anfrage ist abgelaufen oder wurde bereits abgeholt. Registrieren Sie sich erneut.
410sandbox_expiredDer Tagespass ist abgelaufen. Wählen Sie einen Tarif, um die Entwicklung fortzusetzen.
422email_not_allowedDienste für Wegwerf-E-Mail-Adressen sind gesperrt.
422invalid_codeDer Code ist falsch oder abgelaufen. Verwenden Sie den Code aus der neuesten E-Mail.
429too_many_attempts5 falsche Codes. Verwenden Sie stattdessen den Link in der E-Mail.
429rate_limit_exceeded, daily_limit_reached oder domain_limit_reachedZu viele Anfragen. Versuchen Sie es später erneut.
503pass_not_startedDer Tagespass konnte nicht gestartet werden. Wiederholen Sie denselben Aufruf.

MCP verbinden

Der gehostete MCP-Server nimmt den Tagespass-Schlüssel im selben Header wie die REST-API entgegen. Für Claude Code:

Shell
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 mit OAuth-Anmeldung, etwa 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 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:

VerzeichnisAufgeführte Komponenten
Connector-Verzeichnis von ClaudeDer MCP-Server als Claude-Connector. Klicken Sie auf Connect (Verbinden) und melden Sie sich an.
Offizielle MCP RegistryDer MCP-Server, registriert als com.listingsapi/mcp.
Cursor DirectoryDer MCP-Server als Cursor-Plugin.
GlamaDer MCP-Server.
SmitheryDer MCP-Server.
MCP.soDer MCP-Server.
mcpservers.orgDer MCP-Server.
ClawHub (OpenClaw)Der Agent-Skill listingsAPI.
skills.shDer Agent-Skill listingsAPI.

Die Agent-Skills hinzufügen

5 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:

Shell
npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration --skill listingsapi-listing-audit

Einen Standort erstellen

Die Adresse muss tatsächlich existieren und geokodierbar sein, die Telefonnummer muss 10 Stellen haben und die Beschreibung mindestens 200 Zeichen lang sein. Beispieldaten sind in Ordnung, da sie nur an die Demo-Verzeichnisse übermittelt werden.

Request
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.

Synchronisierung verfolgen

Request
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 die Statusänderung beobachten können. Die Demo-Seiten sind als Sandbox-Seiten gekennzeichnet und für Suchmaschinen und KI-Crawler verborgen.

Ein Feld ändern und erneut prüfen

Senden Sie nur die Felder, die Sie ändern. Senden Sie bei Öffnungszeiten die vollständige Woche:

Request
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": [] }      ]    }  }'

Bei der Aktualisierung wird auch dann HTTP 200 zurückgegeben, wenn die Validierung fehlschlägt. Prüfen Sie daher success im Antworttext und lesen Sie anschließend die Premium-Einträge erneut aus.

Prompts zum Ausprobieren

Wenn der MCP-Server verbunden ist, fügen Sie einen dieser Prompts in Ihren Agenten ein:

Einen Standort erstellen

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.

Synchronisierung verfolgen

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.

Die Öffnungszeiten ändern

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 zum 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 ist der Tagespass gültig?

Der Tagespass ist ab der Aktivierung 24 Stunden lang gültig. Sie aktivieren ihn, indem 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 auslesen. Einträge werden nur mit 10 listingsAPI Demo-Verzeichnissen synchronisiert, niemals mit echten Plattformen. Listings scans, Bewertungen, Beiträge, Social, 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 mit einem kostenpflichtigen Tarif und 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 nur in Demo-Verzeichnissen. Pro E-Mail-Adresse kann ein Tagespass genutzt werden, und bestehende Kunden von listingsAPI sind nicht teilnahmeberechtigt.