Obter todas as listagens duplicadas de uma conta

Parâmetros

Query

Nome	Tipo	Obrigatório	Descrição	Padrão
status	string	opcional	Duplicate status to return: `POTENTIAL`, `PROCESSING`, `FIXED`, or `FAILED`. Case-insensitive.	POTENTIAL
siteId	integer	opcional	Narrow to a single publisher by site ID. See the plan-sites endpoint for valid IDs.	—
tag	string	opcional	Tag to scope the rollup to. Defaults to every location the key can see.	all
page	integer	opcional	1-based page number.	1
perPage	integer	opcional	Records per page.	—

Respostas

200Paginated rollup of duplicate listing records across the account.

Response

{  "data": {    "duplicateListingsRollup": {      "pageInfo": {        "hasNextPage": true,        "hasPreviousPage": false,        "totalPages": 34,        "totalRecords": 1673      },      "records": [        {          "id": "3329229",          "name": "Woodbury Train Station",          "nameValid": false,          "duplicateProcessingState": "POTENTIAL",          "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450",          "locationId": "73451",          "siteName": "City Squares",          "siteUrl": "citysquares.com"        }      ]    }  }}

400An invalid `status` value, e.g. one outside `POTENTIAL` / `PROCESSING` / `FIXED` / `FAILED`.

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Retorna uma visão de possíveis listagens duplicadas em todos os diretórios das plataformas de publicação da conta, consolidada para que você possa fazer a triagem de duplicatas em lote em vez de consultar um local por vez. A estrutura pageInfo/records mostrada acima foi verificada com dados reais da conta 12345; essa conta não tem duplicatas em aberto no momento, portanto, o único registro é representativo da estrutura retornada por um local com duplicatas.

Caso de uso: varredura noturna para supressão de duplicatas

Percorra as páginas de duplicatas POTENTIAL de toda a conta e encaminhe cada id a uma pessoa responsável pela análise:

Code

GET /api/v4/locations/listings/duplicates?status=POTENTIAL&page=1

Os filtros são parâmetros de consulta sem aninhamento, não JSON. status e siteId são opcionais. Quando nenhum dos dois é fornecido, status assume o valor padrão POTENTIAL e tag assume all, portanto, uma chamada simples a GET /api/v4/locations/listings/duplicates retorna as duplicatas em aberto da conta em vez de um 400. Percorra as páginas usando pageInfo.hasNextPage e incrementando page até que seu valor seja false; totalRecords e totalPages permitem que você mostre o progresso.

Caso de uso: restringir o escopo a um segmento do seu catálogo

A visão consolidada sempre abrange todos os locais aos quais a chave tem acesso. Para analisar um subconjunto, percorra as páginas do resultado e agrupe pelo locationId de cada registro, ou chame o endpoint por local para os locais de seu interesse.

Quando você tiver id sobre os quais agir, resolva-os com Marcar listagem como duplicada ou descarte falsos positivos com Marcar listagem como não duplicada. Para obter as duplicatas de um único local agrupadas por site, use Obter listagens duplicadas de um local. Este é um endpoint de lista paginada sujeito ao limite de requisições da conta; ao receber 429, aguarde antes de tentar novamente, usando o cabeçalho Retry-After.