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"