/api/v4/locations/{locationId}/listings/duplicatesObtener fichas duplicadas de una ubicación
Devuelve las entradas de fichas duplicadas detectadas para una única ubicación, agrupadas por sitio de la plataforma de publicación.
Parámetros
Ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| locationId | string | obligatorio | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Respuestas
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.
Devuelve todas las fichas duplicadas detectadas para una ubicación, agrupadas por sitio de la plataforma de publicación. Cada grupo es un sitio (name, url) con un array listings de posibles duplicados; cada duplicado incluye un listingItemId y un status. La ubicación en producción Jenny Home actualmente no tiene duplicados y devuelve {"data":{"duplicateListingsForLocation":[]}}, por lo que el grupo con datos mostrado arriba representa la estructura que devuelve una ubicación con duplicados.
Caso de uso: eliminar duplicados que perjudican el SEO local
Las entradas duplicadas en directorios dividen las señales de posicionamiento y confunden a los clientes. Obtén esta lista para una ubicación, examina cada grupo y actúa sobre las entradas que realmente sean duplicados. El listingItemId de cada entrada es exactamente lo que Marcar ficha como duplicada espera en su array listingItemIds:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}Para las entradas que en realidad corresponden a la ficha correcta, descártalas con Marcar ficha como no duplicada para que dejen de aparecer aquí.
Caso de uso: detalle por ubicación tras una revisión general de la cuenta
Usa este endpoint para examinar en detalle una única ubicación después de que Obtener todas las fichas duplicadas de una cuenta muestre qué ubicaciones tienen duplicados pendientes; el resumen de la cuenta te indica dónde, y este endpoint te indica cuáles, agrupados por sitio.
status refleja el estado de gestión: POTENTIAL (detectado, aún sin ninguna acción realizada), PROCESSING, FIXED o FAILED. Esta es una lista por ubicación sujeta al límite de solicitudes de la cuenta; si recibes 429, vuelve a intentarlo una vez transcurrido el tiempo indicado en el encabezado Retry-After.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"