/api/v4/locations/{locationId}/listings/duplicatesBir konumun yinelenen işletme kayıtlarını alın
Tek bir konum için tespit edilen yinelenen işletme kayıtlarını yayın platformu sitesine göre gruplandırılmış olarak döndürür.
Parametreler
Yol
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| locationId | string | zorunlu | Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID. |
Yanıtlar
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.
Bir konum için tespit edilen tüm yinelenen işletme kayıtlarını yayın platformu sitesine göre gruplandırılmış olarak döndürür. Her grup, olası yinelenen kayıtların bulunduğu bir listings dizisini içeren bir siteyi (name, url) temsil eder; her yinelenen kayıt bir listingItemId ve bir status içerir. Canlı konum Jenny Home şu anda yinelenen kayıt içermediği için {"data":{"duplicateListingsForLocation":[]}} döndürür; dolayısıyla yukarıdaki dolu grup, yinelenen kayıtları olan bir konumun döndürdüğü yapıyı temsil eder.
Kullanım senaryosu: yerel SEO'ya zarar veren yinelenen kayıtları temizleyin
Yinelenen dizin kayıtları sıralama sinyallerini böler ve müşterilerin kafasını karıştırır. Bir konum için bu listeyi alın, her grubu inceleyin ve gerçekten yinelenen kayıtlar üzerinde işlem yapın. Her kayıttaki listingItemId, İşletme kaydını yinelenen olarak işaretle işleminin listingItemIds dizisinde beklediği değerin tam karşılığıdır:
{ "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]}Aslında doğru işletme kaydı olan kayıtları, burada artık görünmemeleri için İşletme kaydını yinelenen değil olarak işaretle işlemiyle listeden çıkarın.
Kullanım senaryosu: hesap taramasından sonra konum bazında ayrıntılar
Bir hesaptaki tüm yinelenen işletme kayıtlarını alın işlemi, hangi konumlarda henüz çözümlenmemiş yinelenen kayıtlar olduğunu gösterdikten sonra tek bir konumun ayrıntılarını incelemek için bu endpoint'i kullanın; hesap özeti size nerede olduklarını, bu endpoint ise siteye göre gruplandırarak ne olduklarını gösterir.
status, işlem durumunu yansıtır: POTENTIAL (tespit edildi, henüz işlem yapılmadı), PROCESSING, FIXED veya FAILED. Bu, hesabın istek hız sınırına tabi olan, konum bazında bir listedir; 429 durumunda Retry-After header'ında belirtilen süre geçtikten sonra yeniden deneyin.
curl -X GET 'https://listingsapi.com/api/v4/locations/<locationId>/listings/duplicates' \ -H "Authorization: API $LISTINGSAPI_KEY"