POST/api/v4/locations/listings/mark-as-not-duplicate

将商家信息标记为非重复项

将一个或多个潜在重复项判定为误报并予以排除,使其不再出现在重复项列表中。

需要 API 密钥。请求头格式和密钥轮换请参阅身份验证。

参数

请求体

名称类型必填描述
input.listingItemIdsarray必填Array of base64-encoded listing item IDs to dismiss as not duplicates. Use the `listingItemId` values from the duplicate-listings endpoints.
input.locationIdstring可选Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location.

请求示例

可直接粘贴的请求体。请将占位 ID 和值替换为您自己的。

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

响应

200Listing items dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "data": {    "markAsNotDuplicate": {      "success": true,      "errors": null    }  }}
400Validation error, e.g. an unknown or malformed listing item ID. See the `errors` array (`code`, `message`, `path`).
401Unauthenticated, missing or invalid API key.

将潜在重复项判定为误报并予以排除。排除后,这些条目会被标记为已确认的非重复项,不再出现在获取某个地点的重复商家信息或账户范围内的汇总结果中。使用这些端点返回的 listingItemId 值填充 listingItemIds。

使用场景:清除队列中的误报

检测机制采取保守策略,会将仅仅看起来相似的有效商家信息标记为潜在重复项,例如第二份有效的商家资料、同一连锁品牌的另一家门店或已更名的地点。当审核人员确认某个条目是正确的商家信息时,请将其排除,使其不再占用重复项队列:

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

listingItemIds 为必填项,且接受多个 ID:请在一次调用中批量处理某个地点的所有误报。返回 200 且 success: true 表示已确认排除;success: false 或 400 会附带非空的 errors 数组,供您检查。

使用场景:与屏蔽相反的操作

此端点与将商家信息标记为重复项相对应,并采用完全相同的请求体结构,可用于撤销对误标条目的标记。这两个端点均执行写入操作,会计入账户的速率限制,因此应优先批量处理,避免逐条发送请求。

Request
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-not-duplicate' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "listingItemIds": [        "TGlzdGluZ0l0ZW06MjM1OTg0NTA="      ]    }  }'