/api/v4/locations/{locationId}/listings/duplicatesObter listagens duplicadas de um local
Retorna entradas de listagens duplicadas detectadas para um único local, agrupadas por site da plataforma de publicação.
Parâmetros
Caminho
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| locationId | string | obrigatório | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Respostas
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.
Retorna todas as listagens duplicadas detectadas para um local, agrupadas por site da plataforma de publicação. Cada grupo é um site (name, url) com um array listings de possíveis duplicatas; cada duplicata contém um listingItemId e um status. O local em produção Jenny Home atualmente não tem duplicatas e retorna {"data":{"duplicateListingsForLocation":[]}}, portanto o grupo preenchido acima representa a estrutura retornada para um local com duplicatas.
Caso de uso: remover duplicatas que prejudicam o SEO local
Entradas duplicadas em diretórios dividem os sinais de classificação e confundem os clientes. Obtenha esta lista para um local, analise cada grupo e tome as medidas necessárias para as entradas que realmente são duplicatas. O listingItemId de cada entrada é exatamente o que Marcar listagem como duplicata espera em seu array listingItemIds:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}Para as entradas que na verdade são a listagem correta, descarte-as com Marcar listagem como não duplicada para que deixem de aparecer aqui.
Caso de uso: detalhamento por local após uma verificação de toda a conta
Use este endpoint para examinar um único local em detalhes depois que Obter todas as listagens duplicadas de uma conta mostrar quais locais têm duplicatas pendentes; o resumo da conta informa onde, e este endpoint informa o quê, agrupado por site.
status reflete o estado do tratamento: POTENTIAL (detectado, nenhuma ação tomada ainda), PROCESSING, FIXED ou FAILED. Esta é uma lista por local sujeita ao limite de requisições da conta; em caso de 429, tente novamente após o intervalo indicado no cabeçalho Retry-After.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"