速卖通图片搜索商品 API接口实战-CRMEB社区

速卖通平台可能没有专门的 “图片搜索商品 API”，你想问的可能是按关键字搜索商品的item_search API 或获取商品详情的aliexpress.item_get 。以下为你分别介绍这两个 API 的返回值说明：
item_search API1

产品 ID（productId） ：商品的唯一标识符。
产品标题（productTitle） ：商品的标题，包含了商品的名称和关键特征。
产品 URL（productUrl） ：商品详情页面的链接。
图片 URL（imageUrl） ：商品的主图链接，用于展示商品的图片。
原始价格（originalPrice） ：商品的原始价格。
销售价格（salePrice） ：商品的销售价格，可能包含折扣或促销信息。
销量（volume） ：商品的销售数量，反映了商品的受欢迎程度。

aliexpress.item_get API2

请求 ID（request_id） ：每个 API 请求都会生成一个唯一的请求 ID，用于标识和追踪该请求。
商品 ID（item_id/product_id） ：商品的唯一标识符，用于在速卖通平台上识别和检索商品。
商品标题（title） ：商品的名称或简短描述，用于展示在搜索结果页或商品详情页。
商品价格（price） ：商品的当前售价。
原价或市场参考价（original_price） ：商品的原价或市场参考价，有助于消费者了解商品的折扣程度。
折扣率或折扣金额（discount） ：商品当前的折扣信息，可能是折扣率或具体的折扣金额。
销量（sale_count） ：商品的销售数量，通常以 “1000+” 的形式展示。
商品评分（rating_star） ：商品的平均评分，如 4.5 星、4.8 星等，有助于消费者了解商品的质量。
评分数量（rating_count） ：针对商品的评价数量，有助于消费者了解商品的质量和满意度。
运输信息（shipping） ：包含运输方式列表、是否免运费（free_shipping）等，有助于消费者了解购买商品的物流成本和方式。
商品描述（description/desc） ：商品的详细描述信息，可能包括产品特点、用途、规格等。
商品图片链接列表（images/image_url） ：商品的封面或主要图片链接，用于展示商品的外观。
SKU 列表（sku_list） ：每个 SKU 包含 ID、属性、价格和库存数量，有助于消费者了解商品的规格和库存情况。
其他信息：还可能包括颜色、尺寸、重量、品牌、商品分类、发货地等，这些字段提供了商品的更多详细信息，有助于消费者做出购买决策。

以下是图片搜索商品 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[]		按图搜索1688商品
real_total_results	Int	245	宝贝真实数量
total_results	Int	245	搜索数量
page_count	Int	4	总页数
page	String	1	页码
page_size	String	60	每页商品数量
_ddf	String	alex
item	item[]

封装好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: 找到的最匹配的图片链接（可能是商品主图、也可能是详情图）。

强调：以上是基于常见API结构和经验的通用说明。实际返回字段名、嵌套结构、哪些字段一定返回/可选返回