/api/v4/locations/{locationId}/listings/duplicatesOttieni le schede duplicate per una sede
Restituisce le schede duplicate rilevate per una singola sede, raggruppate per sito della piattaforma di pubblicazione.
Parametri
Percorso
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| locationId | string | obbligatorio | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Risposte
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.
Restituisce tutte le schede duplicate rilevate per una sede, raggruppate per sito della piattaforma di pubblicazione. Ogni gruppo è un sito (name, url) con un array listings di potenziali duplicati; ogni duplicato contiene un listingItemId e un status. La sede in produzione Jenny Home attualmente non ha duplicati e restituisce {"data":{"duplicateListingsForLocation":[]}}, quindi il gruppo popolato riportato sopra è rappresentativo della struttura restituita per una sede con duplicati.
Caso d'uso: elimina i duplicati che danneggiano la SEO locale
Le voci duplicate nelle directory disperdono i segnali di posizionamento e confondono i clienti. Recupera questo elenco per una sede, esamina ogni gruppo e intervieni sulle voci che sono effettivamente duplicate. Il valore listingItemId di ogni voce è esattamente ciò che Contrassegna una scheda come duplicata si aspetta nel suo array listingItemIds:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}Per le voci che in realtà corrispondono alla scheda corretta, escludile con Contrassegna una scheda come non duplicata affinché non compaiano più qui.
Caso d'uso: dettagli per singola sede dopo una verifica dell'account
Usa questo endpoint per esaminare in dettaglio una singola sede dopo che Ottieni tutte le schede duplicate per un account ha mostrato quali sedi hanno duplicati ancora da gestire: il riepilogo dell'account ti indica dove, questo endpoint ti indica quali, raggruppati per sito.
status riflette lo stato di gestione: POTENTIAL (rilevato, non ancora gestito), PROCESSING, FIXED o FAILED. Questo è un elenco per singola sede soggetto al limite di richieste dell'account; in caso di 429, riprova dopo l'intervallo indicato nell'header Retry-After.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"