Synupv1
Criar chave
v1Recursos/Duplicate Listings/getObter listagens duplicadas de um local

Obter listagens duplicadas de um local

Retorna as listagens duplicadas detectadas para um local, agrupadas por publisher, com contagens por status.

get/api/v1/listings/duplicates
listings:read
Parâmetros de consulta
locationIdstringobrigatório
O local a ser consultado. Obrigatório.
clientIdstringopcional
O cliente do local. Necessário apenas para desambiguar quando sua chave está limitada a clientes específicos.
statusstring (potential | flagged | deleted | failed)opcional
Restringe os resultados a um status: potential, flagged, deleted ou failed. As contagens são sempre retornadas para todo status, independentemente deste filtro.
Resposta
dataobjectopcional
foundbooleanopcional
Se o local foi encontrado e estava acessível para esta chave.
yourListingobjectopcional
O próprio nome, endereço e telefone deste local, para comparação com cada linha duplicada. Ausente quando found é false.
namestringopcional
O próprio nome comercial deste local.
addressstringopcional
O próprio endereço deste local.
phonestringopcional
O próprio telefone deste local.
countsobjectopcional
Contagens de listagens duplicadas para este local, por status.
potentialnumberopcional
Número de duplicatas aguardando revisão.
flaggednumberopcional
Número de duplicatas marcadas para remoção.
deletednumberopcional
Número de duplicatas removidas com sucesso.
failednumberopcional
Número de duplicatas cuja tentativa de remoção falhou.
groupsarray of objectopcional
Listagens duplicadas, agrupadas por publisher.
publisherIdstringopcional
Identificador do diretório/publisher (sua URL de site).
publisherNamestringopcional
Nome de exibição do publisher.
originalUrlstringopcional
URL ativa da própria listagem real deste local neste publisher, ou null.
rowsarray of objectopcional
As listagens duplicadas encontradas neste publisher.
idstringopcional
Identificador único desta linha de listagem duplicada.
businessNamestringopcional
Nome do negócio como aparece na listagem duplicada.
businessNameMatchesbooleanopcional
Se o nome do negócio da duplicata corresponde ao próprio nome deste local.
addressstringopcional
Rua, cidade e código postal da listagem duplicada, unidos em uma única string.
addressMatchesbooleanopcional
Se o endereço da duplicata corresponde ao próprio endereço deste local.
phonestringopcional
Número de telefone como aparece na listagem duplicada.
phoneMatchesbooleanopcional
Se o telefone da duplicata corresponde ao próprio telefone deste local.
matchScorenumberopcional
Confiança do modelo, 0–1, de que este é o mesmo negócio que a listagem real, ou null se não pontuado.
duplicateUrlstringopcional
URL ativa da listagem duplicada, ou null.
statusstring (potential | flagged | deleted | failed)opcional
Um de: potential, flagged, deleted, failed.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/listings/duplicates
Sua chave 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
          }
        ]
      }
    ]
  }
}