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

取得地點的重複商家資訊

傳回針對單一地點偵測到的重複商家資訊項目,並依發布平台網站分組。

需要 API 金鑰。標頭格式與金鑰輪替請參閱驗證。

參數

路徑

名稱類型必填說明
locationIdstring必填Location to read. Accepts a base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) or a raw numeric location ID.

回應

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.

傳回針對單一地點偵測到的所有重複商家資訊,並依發布平台網站分組。每個群組代表一個網站(name、url),其中的 listings 陣列包含可能重複的商家資訊;每筆重複商家資訊都包含 listingItemId 和 status。實際地點 Jenny Home 目前沒有重複商家資訊,會傳回 {"data":{"duplicateListingsForLocation":[]}};上方含有資料的群組示範的是有重複商家資訊的地點所傳回的結構。

使用案例:清理影響在地 SEO 的重複商家資訊

重複的目錄項目會分散排名訊號,並讓顧客感到困惑。請取得地點的這份清單,檢視各個群組,並處理確實重複的商家資訊。每個項目的 listingItemId 正是將商家資訊標記為重複 的 listingItemIds 陣列所需的值:

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

對於實際上是正確商家資訊的項目,請使用將商家資訊標記為非重複 將其排除,讓這些項目不再顯示於此處。

使用案例:掃描帳戶後查看各地點的詳細資料

當取得帳戶的所有重複商家資訊 顯示哪些地點有尚未處理完畢的重複商家資訊後,您可以使用此端點深入查看單一地點;帳戶彙總會告訴您哪些地點有重複商家資訊,此端點則會告訴您具體有哪些重複商家資訊,並依網站分組。

status 反映處理狀態:POTENTIAL(已偵測到,尚未採取行動)、PROCESSING、FIXED 或 FAILED。這份清單以單一地點為範圍,並受帳戶的速率限制約束;遇到 429 時,請等待 Retry-After 標頭指定的時間後再重試。

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