/api/v4/locations/{locationId}/listings/premiumPremium-Einträge für einen Standort abrufen
Gibt den Synchronisierungsstatus jedes Plattformverzeichnisses im Plan eines Standorts zurück.
Parameter
Pfad
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| locationId | string | erforderlich | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Antworten
200Array of listings with per-directory sync status.
{ "data": { "listingsForLocation": [ { "id": "TGlzdGluZzoxMDQ0Njg3MjM=", "databaseId": "104468723", "site": { "id": "U2l0ZTox", "databaseId": "1", "name": "Google Maps", "url": "maps.google.com", "syScore": "100" }, "syncStatus": "REQUIRING_ACTION", "displayStatus": "Connect your account to sync the listing", "actionRequired": true, "listingUrl": null, "connectedAccountId": null, "lastUpdate": "2026-07-06T18:33:28Z", "indexStatus": false, "syncIssue": null, "verified": false }, { "id": "TGlzdGluZzoxMDQ0Njg3MTQ=", "databaseId": "104468714", "site": { "id": "U2l0ZToxODA=", "databaseId": "180", "name": "Bing", "url": "www.bing.com", "syScore": "97" }, "syncStatus": "IN_PROGRESS", "displayStatus": "Information submitted to partner; awaiting response", "actionRequired": false, "listingUrl": null, "connectedAccountId": null, "lastUpdate": "2026-07-06T18:33:35Z", "indexStatus": false, "syncIssue": null, "verified": false }, { "id": "TGlzdGluZzoxMDQ0Njg3Mjc=", "databaseId": "104468727", "site": { "id": "U2l0ZTozODc=", "databaseId": "387", "name": "BeLocalFocussed", "url": "belocalfocussed.com", "syScore": "80" }, "syncStatus": "SYNCED", "displayStatus": "Synced", "actionRequired": false, "listingUrl": "https://belocalfocussed.com/jenny-home-26x0ffkd0e", "connectedAccountId": null, "lastUpdate": "2026-07-06T18:33:30Z", "indexStatus": false, "syncIssue": null, "verified": false }, { "id": "TGlzdGluZzoxMDQ0Njg3MDk=", "databaseId": "104468709", "site": { "id": "U2l0ZTozMDE=", "databaseId": "301", "name": "Local Mint", "url": "localmint.com", "syScore": "69" }, "syncStatus": "FAILED", "displayStatus": "Partner experiencing issues; awaiting response", "actionRequired": false, "listingUrl": null, "connectedAccountId": null, "lastUpdate": "2026-07-06T18:34:03Z", "indexStatus": false, "syncIssue": "Publisher requires website URL", "verified": false } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Gibt den Synchronisierungsstatus jedes Plattformverzeichnisses zurück, das im Plan eines Standorts enthalten ist. Jeder Datensatz verknüpft site (Verzeichnismetadaten) mit syncStatus und einem für Menschen lesbaren displayStatus. Das obige Beispiel ist ein gekürzter Auszug aus der Live-Antwort für Jenny Home (die mehr als 30 Verzeichnisse zurückgibt), um jeweils einen Datensatz in jedem der gängigen Zustände zu zeigen.
Die Eintragsstufe ist Teil des Pfads: /listings/premium gibt die Premium-Verzeichnisse des Plans zurück (hier gezeigt), und /listings/additional gibt zusätzliche/kostenlose Einträge zurück. Es gibt keinen Abfrageparameter listingType; ein dort übergebener Wert wird ignoriert.
Anwendungsfall: ein Dashboard zum Zustand der Einträge
Rufen Sie die Premium-Einträge für einen Standort ab und gruppieren Sie sie nach syncStatus, um die Abdeckung auf einen Blick darzustellen: wie viele Verzeichnisse live, in Bearbeitung oder blockiert sind. Zeigen Sie listingUrl für Zeilen mit SYNCED an, damit Benutzer zum Live-Eintrag gelangen können, und lesen Sie displayStatus/syncIssue für alles, was nicht synchronisiert ist (e.g. Publisher requires website URL).
Anwendungsfall: Blockaden anzeigen, die eine Kontoverknüpfung erfordern
Filtern Sie nach actionRequired: true, um die Aufgabenliste des Inhabers zu erstellen. In den Live-Daten werden Google Maps, Facebook und Waze mit REQUIRING_ACTION und displayStatus: "Connect your account to sync the listing" zurückgegeben; diese benötigen eine OAuth-Verbindung, bevor sie synchronisiert werden können. Leiten Sie den Inhaber zum entsprechenden Verknüpfungsablauf weiter und fragen Sie diesen Endpunkt anschließend erneut ab, um die Statusentwicklung zu verfolgen.
Werte für syncStatus: AVAILABLE (bereit zur Synchronisierung, noch nicht gestartet), IN_PROGRESS (an den Partner übermittelt, Antwort ausstehend), PENDING_APPROVAL (Genehmigung durch den Partner ausstehend), SYNCED / COMPLETED (live; listingUrl ausgefüllt), REQUIRING_ACTION (Aktion des Inhabers erforderlich, siehe displayStatus), FAILED (Synchronisierung fehlgeschlagen; siehe syncIssue), CANNOT_SUBMIT (Übermittlung nicht möglich).
Dies ist eine Liste pro Standort, die dem Anfragelimit des Kontos unterliegt; warten Sie bei 429 bis zu dem im Header Retry-After angegebenen Zeitpunkt bzw. für die dort angegebene Dauer, bevor Sie es erneut versuchen, statt sofort erneut abzufragen.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/premium' \ -H "Authorization: API $LISTINGSAPI_KEY"