速卖通的商品图片搜索 API（也称为图片搜索 API 或 Image Search API）的响应格式通常是 JSON 结构化的。
请注意：
- 官方文档是权威： 最准确、最新和完整的返回值说明，请务必参考速卖通开放平台的官方文档。不同版本的 API 可能有细微差异。
- 字段可能变化： 平台会不断更新，字段名称、结构或是否返回某些字段都可能调整。
- 权限限制： 你获取到的具体字段取决于你申请的 API 权限等级（如基本权限、高级权限等）。
- 请求参数影响： 返回的数据量（如商品列表长度）和内容也会受到你的请求参数（如
categoryId,pageSize）的影响。
以下是图片搜索商品 API 返回值的典型结构和常见字段说明：
{
"aliexpress_solution_image_search_response": { // 最外层响应对象，命名可能略有不同
"code": 0, // 数字，必选。请求状态码。0 通常表示成功，非0表示错误（需查错误码表）。
"msg": "success", // 字符串，必选。对状态码的文字描述。
"request_id": "your_request_id_here", // 字符串，必选。本次请求的唯一标识，用于追踪问题。
"total_count": 100, // 整数，可选。根据搜索条件预估可返回的总商品数（可能不完全精确）。
"result": { // 对象，包含核心搜索结果
"items": [ // 数组，必选。包含搜索到的商品信息列表，每个元素是一个商品对象。
{
//封装好API供应商demo url=o0b.cn/ibrad 复制链接获取测试
// 核心商品信息 (与商品列表API / item详情API 结构相似)
"product_id": "1000000000000", // 数字/字符串，必选。商品ID（通常是一个很大的数字）。
"image_url": "https://...", // 字符串，可选。商品的主图URL (可能是API搜索时使用的图片，也可能是商品本身的主图)。
"title": "New Fashion Women Dress...", // 字符串，必选。商品标题。
"target_sale_price": "12.99", // 字符串，必选。目标销售价格（通常展示给用户的到手价），单位美元。注意是字符串。
"target_original_price": "19.99", // 字符串，可选。目标商品原价（划线价），单位美元。注意是字符串。
"target_discount": "35", // 字符串，可选。目标商品的折扣百分比（如：35 表示35% off）。
"store_name": "Fashion Store", // 字符串，可选。卖家店铺名称。
"store_url": "https://...", // 字符串，可选。卖家店铺链接。
"product_detail_url": "https://aliexpress.com/item/1000000000000.html", // 字符串，必选。商品详情页URL。
// **图片搜索相关特定字段 (重点留意)**
"simi_score": 0.85, // 浮点数，可选。图片搜索算法计算出的该商品图片与你上传图片的相似度得分，范围通常为 0-1 或 0-100。值越高表示越相似。**这是图片搜索API特有的关键字段！**
"search_image": "https://...", // 字符串，可选。在商品中搜索到的、与你上传图片最匹配的那张图片的URL。
// 其他常用商品信息 (视权限和API版本)
"currency": "USD", // 字符串，可选。价格对应的货币代码（如 USD, EUR, GBP）。
"orders": 999, // 整数，可选。该商品近期销量（如30天销量，具体口径看文档）。
"package_type": "piece", // 字符串，可选。商品类型（如 piece/包裹, lot/批, pair/对）。
"lot_num": 1, // 整数，可选。如果是批售，表示每批的数量。
"freight_info": { // 对象，可选。运费相关信息（具体结构可能比较复杂）
"freight": {
"freight_amount": "2.99", // 运费金额字符串
"display_name": "Standard Shipping" // 运费显示名
},
"freight_to": "US" // 运送到国家
},
"evaluate_rate": "96.3%", // 字符串，可选。卖家评价率（如96%好评）。
"feedbacks": 5000 // 整数，可选。历史评价总数。
},
// ... 更多商品项 ...
],
// 分页信息
"current_page_no": 1, // 整数，必选。当前页码。
"page_size": 20, // 整数，必选。每页返回的商品数量（由请求参数决定）。
"total_page_count": 5, // 整数，可选。根据 `total_count` 和 `page_size` 计算的总页数。
}
}
}
请求参数
请求参数：imgid=images-eu.ssl-images-amazon.com/images/I/61…AC_UL600_SR600,400.jpg
参数说明：imgid:图片url
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 0 | 按图搜索1688商品 | |
| real_total_results | Int | 0 | 245 | 宝贝真实数量 |
| total_results | Int | 0 | 245 | 搜索数量 |
| page_count | Int | 0 | 4 | 总页数 |
| page | String | 0 | 1 | 页码 |
| page_size | String | 0 | 60 | 每页商品数量 |
| _ddf | String | 0 | alex | |
| item | item[] | 0 |
封装好API供应商注册账号直接使用
关键字段总结和说明：
-
code和msg: 核心状态指示器。code == 0是成功的关键标志。任何非0值都表示错误，需要根据msg或速卖通提供的错误码表进行排查（如 API 调用次数超限、参数无效、签名错误、图片识别失败等）。 -
request_id: 非常重要。当 API 调用出现问题时，提供给速卖通技术支持以定位具体请求。 -
result.items: 核心数据。 包含搜索结果的商品对象数组。你主要需要处理这个数组。 - 商品对象中的关键字段:
-
product_id: 唯一标识一个商品，后续操作（如添加到购物车、下单）都需要它。 -
image_url/search_image: 展示商品图片。 -
title: 展示商品名称。 -
target_sale_price/target_original_price/target_discount: 核心价格信息。注意它们是字符串格式。 -
product_detail_url: 用户点击跳转到详情页的链接。 -
simi_score(重点！): 图片搜索 API 特有的关键指标！ 它告诉你系统认为这个商品与你上传的图片有多相似。值越高越相关（但具体含义和分值范围请查最新文档）。
-
simi_scorevssearch_image:
-
simi_score: 量化相似度的数值。 -
search_image: 找到的最匹配的图片链接（可能是商品主图、也可能是详情图）。
- 分页字段 (
current_page_no,page_size,total_page_count,total_count): 用于控制结果的分页显示。total_count通常是估算值。 - 其他业务字段 (
orders,evaluate_rate,freight_info等): 提供更丰富的商品信息，增强用户体验，是否返回取决于你的 API 权限和调用参数。 - 测试不同图片： 尝试上传清晰、主体明确、背景简单的图片，效果通常更好。复杂或有水印的图片识别准确率可能降低。
每个商品对象通常会包含itemId、标题、主图、价格、店铺名这些基础字段。比较特殊的是图片搜索相关的字段如图片相似度分数simiScore或者商品的主图地址searchImage。这些字段是图片搜索API特有的，需要提醒用户关注这一点。
需要提醒用户注意：价格类字段可能存在币种转换的逻辑，订单类字段如feedback可能对应多个排序维度。另外接口很可能会随着时间而变化的，使用中的异常状态码处理机制也很重要。
最后应该强调实际开发时一定要查最新的官方文档，因为不同版本API的参数差异可能很大。如果用户测试时遇到401错误之类的问题可能需要重新检查签名机制或者AppKey配置。
强调：以上是基于常见API结构和经验的通用说明。实际返回字段名、嵌套结构、哪些字段一定返回/可选返回
