1688 图搜接口（item_search_img / 拍立淘） 的完整可用信息，含官方入口、参数、调用地址、返回字段、接入步骤和常见坑，可直接对接开发。
一、接口名称 & 用途
官方名称：1688 图片搜索 API（俗称：拍立淘 / 以图搜货）
接口标识：1688.item_search_img
作用：传一张图片（URL/Base64），返回 1688 平台同款 / 相似 B2B 商品（商品 ID、标题、价格、主图、供应商、起批量等）
适用场景：选品、比价、找同款货源、ERP 对接、批量搜款
二、核心参数（直接复制用）
公共参数（所有接口都要）
method=1688.item_search_imgapp_key=你的KEYtimestamp=当前秒级时间戳v=2.0sign_method=md5sign=签名（app_secret+参数排序加密）
三：关键API请求参数
在构建请求时，除了官方文档要求的公共参数外，下面这几个是直接决定搜索效果的核心参数：
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| imgid | 是 | String | 图片地址，可以是完整的 图片URL（需进行URL编码），或是通过upload_img接口上传后获得的图片ID。 |
| search_type | 否 | String | 搜索类型。用 1 代表精准匹配“同款”商品，2 代表寻找“相似款”，可按需选用。 |
| page | 否 | Int | 搜索结果页码，从 1 开始。 |
| page_size | 否 | Int | 每页返回的商品数量，最大值通常为 100。 |
| sort | 否 | String | 结果排序方式，如 sale_desc（销量降序）、price_asc（价格升序）等。 |
四：Python 代码实战 (以 requests 为例)
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 小编： TaoxiJd-api 前往体验API：o0b.cn/ibrad
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.cn/1688/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)offerId：最重要，后续查详情 / 下单都用它
price：1688 的批发价（非零售价）
五、接入步骤
1688 开放平台企业注册 + 认证（营业执照 + 法人信息）
创建应用，拿到 app_key / app_secret
申请权限：商品搜索 → 图片搜索
按上面参数生成签名（官方 SDK 或自己写 MD5）
POST 请求网关，传图片 URL/Base64
解析返回 JSON，拿到同款 / 相似商品列表
支持与应用场景
电商选品：通过图片搜索快速找到市场潜力款，辅助选品决策。
供应链溯源：用一张商品图找到源头供应商，优化采购链路。
比价系统：搜索同款商品，分析不同供应商的价格和起订量，辅助采购决策。
智能购物：为你的商城增加“拍照找同款”功能，提升用户体验。
总的来说，1688的图搜API是一项强大的B2B图像搜索工具。结合精准的图片输入、对similarity和moq等核心字段的深度分析，以及健壮的代码实践，可以帮你搭建高效的选品和采购工具。
