Alle doppelten Einträge für ein Konto abrufen

Parameter

Query

Name	Typ	Erforderlich	Beschreibung	Standard
status	string	optional	Duplicate status to return: `POTENTIAL`, `PROCESSING`, `FIXED`, or `FAILED`. Case-insensitive.	POTENTIAL
siteId	integer	optional	Narrow to a single publisher by site ID. See the plan-sites endpoint for valid IDs.	—
tag	string	optional	Tag to scope the rollup to. Defaults to every location the key can see.	all
page	integer	optional	1-based page number.	1
perPage	integer	optional	Records per page.	—

Antworten

200Paginated rollup of duplicate listing records across the account.

Response

{  "data": {    "duplicateListingsRollup": {      "pageInfo": {        "hasNextPage": true,        "hasPreviousPage": false,        "totalPages": 34,        "totalRecords": 1673      },      "records": [        {          "id": "3329229",          "name": "Woodbury Train Station",          "nameValid": false,          "duplicateProcessingState": "POTENTIAL",          "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450",          "locationId": "73451",          "siteName": "City Squares",          "siteUrl": "citysquares.com"        }      ]    }  }}

400An invalid `status` value, e.g. one outside `POTENTIAL` / `PROCESSING` / `FIXED` / `FAILED`.

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Gibt eine kontoweite Übersicht potenziell doppelter Einträge über alle Plattformverzeichnisse hinweg zurück, die so zusammengefasst ist, dass Sie Duplikate gesammelt sichten und priorisieren können, anstatt jeden Standort einzeln abzufragen. Die oben gezeigte pageInfo/records-Struktur wurde live anhand des Kontos 12345 verifiziert; dieses Konto hat derzeit keine offenen Duplikate, daher veranschaulicht der einzelne Datensatz die Struktur, die ein Standort mit Duplikaten zurückgibt.

Anwendungsfall: nächtlicher Durchlauf zur Unterdrückung von Duplikaten

Rufen Sie die Duplikate mit dem Status POTENTIAL für das gesamte Konto seitenweise ab und übergeben Sie jedes id zur Prüfung:

Code

GET /api/v4/locations/listings/duplicates?status=POTENTIAL&page=1

Filter sind flache Abfrageparameter, kein JSON. status und siteId sind beide optional. Wenn keiner der beiden Parameter angegeben wird, verwendet status standardmäßig POTENTIAL und tag standardmäßig all, sodass ein bloßer GET /api/v4/locations/listings/duplicates die offenen Duplikate des Kontos anstelle eines 400 zurückgibt. Blättern Sie mit pageInfo.hasNextPage durch die Ergebnisse und erhöhen Sie dabei page, bis der Wert false ist; mit totalRecords und totalPages können Sie den Fortschritt anzeigen.

Anwendungsfall: auf ein Segment Ihres Katalogs eingrenzen

Die Zusammenfassung umfasst immer alle Standorte, auf die der Schlüssel Zugriff hat. Um eine Teilmenge zu prüfen, rufen Sie das Ergebnis seitenweise ab und gruppieren Sie die Datensätze nach dem jeweiligen Wert von locationId, oder rufen Sie den Endpunkt für einzelne Standorte für die gewünschten Standorte auf.

Sobald Ihnen id zur Bearbeitung vorliegen, erledigen Sie diese mit Eintrag als Duplikat markieren oder verwerfen Sie fälschlich erkannte Duplikate mit Eintrag als Nicht-Duplikat markieren. Für die nach Website gruppierten Duplikate eines einzelnen Standorts verwenden Sie Doppelte Einträge für einen Standort abrufen. Dies ist ein paginierter Listenendpunkt, der dem Anfragelimit des Kontos unterliegt; wenn er 429 zurückgibt, warten Sie entsprechend der Angabe im Header Retry-After, bevor Sie weitere Anfragen senden.