/api/v4/locations/{locationId}/listings/duplicatesObtenir les fiches en double d’un établissement
Renvoie les fiches en double détectées pour un seul établissement, regroupées par site de plateforme de publication.
Paramètres
Chemin
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| locationId | string | obligatoire | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Réponses
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.
Renvoie toutes les fiches en double détectées pour un établissement, regroupées par site de plateforme de publication. Chaque groupe correspond à un site (name, url) et contient un tableau listings de doublons potentiels ; chaque doublon comporte un listingItemId et un status. L’établissement Jenny Home en production ne présente actuellement aucun doublon et renvoie {"data":{"duplicateListingsForLocation":[]}} ; le groupe contenant des données ci-dessus illustre donc la structure renvoyée pour un établissement présentant des doublons.
Cas d’utilisation : supprimer les doublons qui nuisent au référencement local
Les entrées en double dans les annuaires dispersent les signaux de classement et sèment la confusion chez les clients. Récupérez cette liste pour un établissement, examinez chaque groupe et traitez les entrées qui sont réellement des doublons. Le listingItemId de chaque entrée correspond exactement à ce que Marquer une fiche comme doublon attend dans son tableau listingItemIds :
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}Pour les entrées qui correspondent en réalité à la bonne fiche, écartez-les avec Marquer une fiche comme n’étant pas un doublon afin qu’elles n’apparaissent plus ici.
Cas d’utilisation : examiner le détail par établissement après une analyse du compte
Utilisez ce point de terminaison pour examiner un établissement en détail après que Obtenir toutes les fiches en double d’un compte a indiqué quels établissements présentent des doublons non résolus ; la synthèse du compte vous indique où, ce point de terminaison vous indique quoi, avec un regroupement par site.
status reflète l’état du traitement : POTENTIAL (détecté, pas encore traité), PROCESSING, FIXED ou FAILED. Il s’agit d’une liste propre à un établissement, soumise à la limite de débit du compte ; en cas de 429, réessayez après le délai indiqué dans l’en-tête Retry-After.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"