GET/api/v4/locations/{locationId}/listings/duplicates

Dapatkan profil bisnis duplikat untuk suatu lokasi

Mengembalikan entri profil bisnis duplikat yang terdeteksi untuk satu lokasi, dikelompokkan berdasarkan situs platform publikasi.

Memerlukan kunci API. Lihat Autentikasi untuk format header dan rotasi kunci.

Parameter

Path

NamaTipeWajibDeskripsi
locationIdstringwajibLocation to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID.

Respons

200Duplicate listings grouped by site. Each group carries the primary listing plus an array of detected duplicates.
Response
{  "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.

Mengembalikan semua profil bisnis duplikat yang terdeteksi untuk satu lokasi, dikelompokkan berdasarkan situs platform publikasi. Setiap kelompok merupakan sebuah situs (name, url) dengan array listings berisi entri yang berpotensi duplikat; setiap duplikat memuat listingItemId dan status. Lokasi aktif Jenny Home saat ini tidak memiliki duplikat dan mengembalikan {"data":{"duplicateListingsForLocation":[]}}, sehingga kelompok berisi data di atas menggambarkan struktur yang dikembalikan oleh lokasi yang memiliki duplikat.

Kasus penggunaan: membersihkan duplikat yang merugikan SEO lokal

Entri direktori duplikat memecah sinyal pemeringkatan dan membingungkan pelanggan. Ambil daftar ini untuk suatu lokasi, tinjau setiap kelompok, dan tindak lanjuti entri yang benar-benar merupakan duplikat. listingItemId pada setiap entri adalah nilai persis yang diharapkan oleh Tandai profil bisnis sebagai duplikat dalam array listingItemIds:

JSON
{  "locationId": "TG9jYXRpb246MTgwMDI4OQ==",  "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}

Untuk entri yang sebenarnya merupakan profil bisnis yang benar, abaikan entri tersebut dengan Tandai profil bisnis sebagai bukan duplikat agar tidak lagi muncul di sini.

Kasus penggunaan: detail per lokasi setelah pemeriksaan seluruh akun

Gunakan endpoint ini untuk memeriksa satu lokasi secara mendetail setelah Dapatkan semua profil bisnis duplikat untuk suatu akun menunjukkan lokasi mana yang memiliki duplikat yang belum ditangani; ringkasan akun memberi tahu Anda di mana, sedangkan endpoint ini memberi tahu Anda apa saja, dikelompokkan berdasarkan situs.

status mencerminkan status penanganan: POTENTIAL (terdeteksi, belum ditindaklanjuti), PROCESSING, FIXED, atau FAILED. Ini adalah daftar per lokasi yang tunduk pada batas laju akun; jika menerima 429, coba lagi setelah waktu yang ditentukan dalam header Retry-After.

Request
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \  -H "Authorization: API $LISTINGSAPI_KEY"