/api/v4/locations/{locationId}/listings/duplicatesDoppelte Einträge für einen Standort abrufen
Gibt doppelte Einträge zurück, die für einen einzelnen Standort erkannt wurden, gruppiert nach Website der Plattform.
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
200Duplicate listings grouped by site. Each group carries the primary listing plus an array of detected duplicates.
{ "data": { "duplicateListingsForLocation": [ { "id": "U2l0ZToxNTA=", "name": "City Squares", "url": "citysquares.com", "listings": [ { "id": "RHVwbGljYXRlOjIzNTk4NDUw", "listingItemId": "TGlzdGluZ0l0ZW06MjM1OTg0NTA=", "name": "Woodbury Train Station", "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450", "status": "POTENTIAL" } ] } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Gibt alle erkannten doppelten Einträge für einen Standort zurück, gruppiert nach Website der Plattform. Jede Gruppe entspricht einer Website (name, url) mit einem listings-Array potenzieller Duplikate; jedes Duplikat enthält einen listingItemId und einen status. Der produktive Standort Jenny Home hat derzeit keine Duplikate und gibt {"data":{"duplicateListingsForLocation":[]}} zurück, sodass die oben gezeigte befüllte Gruppe die Struktur veranschaulicht, die für einen Standort mit Duplikaten zurückgegeben wird.
Anwendungsfall: Duplikate bereinigen, die der lokalen SEO schaden
Doppelte Verzeichniseinträge verteilen Ranking-Signale auf mehrere Einträge und verwirren Kunden. Rufen Sie diese Liste für einen Standort ab, prüfen Sie jede Gruppe und bearbeiten Sie die Einträge, die tatsächlich Duplikate sind. Der listingItemId jedes Eintrags ist genau der Wert, den Eintrag als Duplikat markieren in seinem listingItemIds-Array erwartet:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}Verwerfen Sie Einträge, die tatsächlich der korrekte Eintrag sind, mit Eintrag als kein Duplikat markieren, damit sie hier nicht mehr angezeigt werden.
Anwendungsfall: Details pro Standort nach einer kontoweiten Prüfung
Verwenden Sie diesen Endpunkt, um einen einzelnen Standort genauer zu untersuchen, nachdem Alle doppelten Einträge für ein Konto abrufen gezeigt hat, welche Standorte offene Duplikate haben; die Kontoübersicht zeigt Ihnen, wo diese vorhanden sind, und dieser Endpunkt zeigt Ihnen, welche es sind, gruppiert nach Website.
status gibt den Bearbeitungsstatus an: POTENTIAL (erkannt, noch nicht bearbeitet), PROCESSING, FIXED oder FAILED. Diese Liste gilt für einen einzelnen Standort und unterliegt dem Anfragelimit des Kontos; wiederholen Sie bei 429 die Anfrage nach der im Header Retry-After angegebenen Wartezeit.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"