商品链接解析 API 接口文档

POST/image/v2/make/imageReplication/reference/parseapplication/json

请求体

replicationModestring必填

SINGLE_IMAGE 提取商品主副图；APLUS 提取商品 A+ 图片。

urlOrProductIdstring必填

Amazon 商品详情页完整链接，或 10 位字母、数字组成的 ASIN。

platformstring可选

平台编码 AMAZON，可省略。完整链接由服务端自动识别。

marketplacestring可选

Amazon 站点编码，如 AMAZON_US（美国）、AMAZON_GB（英国）、AMAZON_JP（日本）、AMAZON_DE（德国）。传 ASIN 时有效，未传默认为 AMAZON_US；传完整链接时以链接域名为准。

请求示例

商品主副图

JSON

{
  "replicationMode": "SINGLE_IMAGE",
  "urlOrProductId": "https://www.amazon.com/dp/B0EXAMPLE1"
}

A+ 图片（使用 ASIN）

JSON

{
  "replicationMode": "APLUS",
  "urlOrProductId": "B0EXAMPLE1",
  "marketplace": "AMAZON_US"
}

提交后返回什么

保存返回的 data.previewId，用于查询解析结果。

JSON

{
  "code": 200,
  "msg": "成功",
  "data": {
    "previewId": "plp_1930923414987821056",
    "status": "PROCESSING"
  }
}

查询解析结果

POST/image/v2/make/imageReplication/reference/parse/infoapplication/json

请求体

previewIdstring必填

提交返回的 data.previewId，原样传入。

请求示例

JSON

{
  "previewId": "plp_1930923414987821056"
}

返回字段

codeinteger

200 表示接口调用成功，解析是否完成由 data.status 判断。

msgstring

接口调用提示。

dataobject

解析结果；图片和商品信息在解析成功时返回。

对象字段

previewIdstring

本次解析任务标识。

statusstring

解析状态，见下表。

errorMessagestring

失败或结果不可用时的提示，可能为空或省略。

platformstring

商品平台，值为 AMAZON。

marketplacestring

商品站点，如 AMAZON_US。

referenceImagesarray[object]

参考图片列表，按地址保序去重；使用前检查列表是否非空。

数组元素

indexinteger

图片序号，从 1 开始。

imageUrlstring

参考图片地址。

productInfoobject

商品信息，子字段可能为空或省略。

对象字段

titlestring

商品标题。

bulletPointsstring

商品卖点文本。

pricestring

商品价格。

currencystring

货币编码，如 USD。

brandNamestring

品牌名称。

解析状态

状态	说明
`PROCESSING`	解析中，或等待服务端结算。
`SUCCESS`	解析成功。
`FAILED`	解析失败。
`EXPIRED`	结果过期、解析未成功后已回补，或当前身份无法读取。

返回示例

JSON

{
  "code": 200,
  "msg": "成功",
  "data": {
    "previewId": "plp_1930923414987821056",
    "status": "SUCCESS",
    "platform": "AMAZON",
    "marketplace": "AMAZON_US",
    "referenceImages": [
      { "index": 1, "imageUrl": "https://example.com/reference-1.jpg" },
      { "index": 2, "imageUrl": "https://example.com/reference-2.jpg" }
    ],
    "productInfo": {
      "title": "示例商品",
      "bulletPoints": "便携、防漏，适合日常使用。",
      "price": "29.99",
      "currency": "USD",
      "brandName": "示例品牌"
    }
  }
}

建议每隔 2～3 秒查询一次，直到状态为 SUCCESS、FAILED 或 EXPIRED。客户端等待超时不代表服务端任务失败，不要因此自动重新提交。成功结果从服务端结算完成起保存 2 小时，请及时保存。

扣费标准

解析内容	每次解析
商品主副图或 A+ 图片	15 算力点

提交时预扣，成功后保留扣点；提交失败、解析失败或服务端超时后回补，回补可能异步完成。账户或团队可用额度不足时不能提交。

重复解析同一商品仍按次计费，查询结果不额外扣点。