阿里巴巴按图搜索1688商品（拍立淘）API 返回值说明

阿里巴巴按图搜索1688商品（拍立淘）API 的返回值通常以 JSON 格式返回，包含搜索结果、商品信息、分页信息等。以下是具体的返回值说明：

---

1. 请求状态信息

• code：状态码，通常为 200 表示请求成功，其他值表示错误（如 401 表示未授权，429 表示请求频率过高）。
• msg：请求状态描述信息，例如 "success" 表示成功，"Unauthorized" 表示未授权。
• request_id：请求的唯一标识符，用于追踪和调试请求。

---

2. 搜索结果信息

• items：商品列表，包含搜索到的商品信息，每个商品为一个对象，包含以下字段：
  • num_iid：商品 ID，1688 平台上商品的唯一标识。
  • title：商品标题，商品的名称或简短描述。
  • pic_url：商品主图 URL，商品的图片地址。
  • price：商品价格，商品的售价。
  • original_price：商品原价（如有）。
  • promotion_price：促销价（如有）。
  • sales：商品销量，商品的累计销量。
  • seller_nick：卖家昵称，提供该商品的店铺名称。
  • area：卖家所在地，商品的发货地或卖家所在地。
  • detail_url：商品详情页 URL，点击后跳转到商品详情页面。
  • similarity_score（可选）：相似度得分，表示上传图片与商品的相似程度（通常为 0 到 1 之间的浮点数）。

---

3. 分页信息

• page_size：每页返回的商品数量。
• page_number：当前页码。
• total_results：搜索结果的总商品数量。
• total_pages：总页数。

---

4. 错误信息（如有）

• error：错误信息，包含错误代码和错误描述。例如：

  json复制代码

  	{
  	"error": {
  	"code": 401,
  	"message": "Unauthorized: Invalid API Key"
  	}
  	}

---

5. 示例返回值

以下是一个示例返回值：

json复制代码

	{
	"code": 200,
	"msg": "success",
	"request_id": "12345abcde",
	"items": [
	{
	"num_iid": "6789012345678",
	"title": "2024新款秋冬加绒卫衣",
	"pic_url": "https://img.alicdn.com/imgextra/i1/123456789/O1CN01XXXXXXXXX_XX.jpg",
	"price": "89.00",
	"original_price": "129.00",
	"promotion_price": "79.00",
	"sales": 1234,
	"seller_nick": "某某旗舰店",
	"area": "广东 广州",
	"detail_url": "https://detail.1688.com/offer/123456789.html",
	"similarity_score": 0.95
	},
	{
	"num_iid": "8765432109876",
	"title": "秋冬加绒连帽卫衣女",
	"pic_url": "https://img.alicdn.com/imgextra/i2/234567890/O1CN01YYYYYYYYY_XX.jpg",
	"price": "99.00",
	"original_price": "159.00",
	"promotion_price": "89.00",
	"sales": 567,
	"seller_nick": "某某服饰店",
	"area": "浙江 杭州",
	"detail_url": "https://detail.1688.com/offer/234567890.html",
	"similarity_score": 0.92
	}
	],
	"page_size": 10,
	"page_number": 1,
	"total_results": 25,
	"total_pages": 3
	}

---

6. 注意事项

• 权限与认证：使用拍立淘 API 需要申请 API Key，并确保 API Key 具有调用权限。可以通过万邦开放平台获取Key账号和调用权限。
• 请求频率限制：API 调用有频率限制，超出限制可能会返回 429 Too Many Requests 错误。
• 图片要求：上传的图片需清晰、完整，以提高识别准确率。
• 数据准确性：搜索结果可能因图片质量、算法匹配度等因素而有所差异。

---

通过以上返回值说明，开发者可以解析 API 返回的数据，并在应用中展示搜索结果，例如商品列表、商品详情页链接等。