Synupv1
Crear clave
v1Recursos/Duplicate Listings/getObtener los listados duplicados de una ubicación

Obtener los listados duplicados de una ubicación

Devuelve los listados duplicados detectados para una ubicación, agrupados por publisher, con recuentos por estado.

get/api/v1/listings/duplicates
listings:read
Parámetros de consulta
locationIdstringobligatorio
La ubicación a consultar. Obligatorio.
clientIdstringopcional
El cliente de la ubicación. Solo es necesario para desambiguar cuando su clave está limitada a clientes específicos.
statusstring (potential | flagged | deleted | failed)opcional
Restringe los resultados a un estado: potential, flagged, deleted o failed. Los recuentos siempre se devuelven para todos los estados, independientemente de este filtro.
Respuesta
dataobjectopcional
foundbooleanopcional
Si la ubicación se encontró y era accesible para esta clave.
yourListingobjectopcional
El nombre, dirección y teléfono propios de esta ubicación, para comparar con cada fila duplicada. Ausente cuando found es false.
namestringopcional
El nombre comercial propio de esta ubicación.
addressstringopcional
La dirección propia de esta ubicación.
phonestringopcional
El número de teléfono propio de esta ubicación.
countsobjectopcional
Recuentos de listados duplicados de esta ubicación, por estado.
potentialnumberopcional
Número de duplicados pendientes de revisión.
flaggednumberopcional
Número de duplicados marcados para eliminación.
deletednumberopcional
Número de duplicados eliminados correctamente.
failednumberopcional
Número de duplicados cuyo intento de eliminación falló.
groupsarray of objectopcional
Listados duplicados, agrupados por publisher.
publisherIdstringopcional
Identificador del directorio/publisher (su URL de sitio).
publisherNamestringopcional
Nombre visible del publisher.
originalUrlstringopcional
URL en vivo del listado real propio de esta ubicación en este publisher, o null.
rowsarray of objectopcional
Los listados duplicados encontrados en este publisher.
idstringopcional
Identificador único de esta fila de listado duplicado.
businessNamestringopcional
Nombre del negocio tal como aparece en el listado duplicado.
businessNameMatchesbooleanopcional
Si el nombre del negocio del duplicado coincide con el nombre propio de esta ubicación.
addressstringopcional
Calle, ciudad y código postal del listado duplicado, combinados en una sola cadena.
addressMatchesbooleanopcional
Si la dirección del duplicado coincide con la dirección propia de esta ubicación.
phonestringopcional
Número de teléfono tal como aparece en el listado duplicado.
phoneMatchesbooleanopcional
Si el número de teléfono del duplicado coincide con el número de teléfono propio de esta ubicación.
matchScorenumberopcional
Confianza del modelo, de 0 a 1, de que se trata del mismo negocio que el listado real, o null si no se puntuó.
duplicateUrlstringopcional
URL en vivo del listado duplicado, o null.
statusstring (potential | flagged | deleted | failed)opcional
Uno de: potential, flagged, deleted, failed.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/listings/duplicates
Su clave de API
locationId *
clientId
status
{
  "data": {
    "found": true,
    "yourListing": {
      "name": "Acme Dental — Downtown",
      "address": "123 Main St, Austin, TX 78701",
      "phone": "+15125551234"
    },
    "counts": {
      "potential": 2,
      "flagged": 1,
      "deleted": 0,
      "failed": 0
    },
    "groups": [
      {
        "publisherId": "yelp",
        "publisherName": "Yelp",
        "status": "potential",
        "duplicates": [
          {
            "id": "dup_1",
            "name": "Acme Dental Downtown",
            "address": "123 Main St, Austin, TX",
            "phone": "+15125551234",
            "url": "https://yelp.com/biz/acme-dental-downtown",
            "matchScore": 0.92
          }
        ]
      }
    ]
  }
}