跳转到主要内容
通过异步任务 API 搜索 Target(target.com)的商品并读取商品页面。发送 COMMERCE_SERP 并设置 site target,按商城的顺序获取搜索结果中的商品;向 COMMERCE_PRODUCT 传入商品的 url,读取该商品。每次完成的搜索或商品页面消耗 0.5 积分。

搜索

提交任务后,轮询 GET /v1/async/task/{id} 或通过 webhook 接收。参见异步任务。

参数

  • site:必填。值为 target。
  • query:必填。搜索词,1-500 个字符。
  • limit:可选整数,范围 1-40,默认 20。
  • country:可选。默认是商城所在国家 US。其他国家会以 422 REGION_UNSUPPORTED 拒绝。
仅接受上方列出的载荷字段。请省略 include:即使是 include: {},也会在冻结积分前返回针对 payload.include 的 422 VALIDATION_ERROR。

响应示例

结果字段

  • site、query 和 country 回显请求。returnedCount 是 products 中的商品数。
  • 每个商品包含 rank、productId、title 和 url。productId 是商城自己的商品 ID。rank 遵循商城的默认排序,商城标为广告的商品会被跳过。
  • 搜索结果页显示时返回 price、rating、reviewCount、imageUrl 和 brand。price 是以商品的 currency(ISO 4217)计的数字;不同规格分别定价时,取最低价。 Target 的价格是其默认线上商店的价格。
  • rating 为五分制。像 999+ 这样的缩写评价数不会返回。
  • 每次搜索从商城搜索结果的第一页获取商品。 Target 会把部分搜索转到相关搜索,此时返回该搜索的商品。

商品页面

参数

  • url:必填。Target 的商品页面,最多 2,048 个字符,格式为 target.com/p/{name}/-/A-{TCIN}。搜索返回的商品 url 可直接使用。跟踪代码等不影响结果的参数会在读取前去掉。
  • country:可选。默认是页面所在国家 US。其他国家会以 422 REGION_UNSUPPORTED 拒绝。
仅接受上方列出的载荷字段。请省略 include:即使是 include: {},也会在冻结积分前返回针对 payload.include 的 422 VALIDATION_ERROR。

响应示例

结果字段

  • site、country、url 和 productId 标识页面。url 是读取的页面,productId 与搜索返回的 ID 一致。
  • title 始终返回。页面显示时返回 brand、price、listPrice、currency、rating、reviewCount、images、description、specs、categories 和 gtin。
  • price 是页面最初显示、未计优惠券和运费的购买价格,以 currency(ISO 4217)计。 listPrice 是页面划线显示的原价,高于 price 时才返回。
  • rating 为五分制,保留两位小数。 reviewCount 是评价数。
  • images 按页面顺序列出商品图库中最多 30 张图片。
  • description 是每段一行的纯文本,最多 10,000 个字符;只出现在图片中的文字不包含在内。
  • specs 列出商品详情中最多 100 组 { name, value }。 categories 从最宽的类目排到最窄的类目,最多 10 级。 gtin 是页面列出的 UPC、EAN 或 JAN。

错误与计费

  • 没有返回任何商品的搜索以失败任务结束。
  • 商城以 404 或 410 响应的商品页面(例如已下架的商品)会以 PAGE_UNAVAILABLE 结束任务,消息中带有商城的响应。如果商城以 403、412、429 或 435 拒绝读取,任务会等待并在最多 6 分钟内重新请求。其他读取失败,以及持续更久的拒绝,以 ENGINE_NO_RESULT 结束。
  • 只对完成的任务计费:每次搜索或每个商品页面 0.5 积分。

相关