1688 图搜接口(item_search_img / 拍立淘) 接入方法

1688 图搜接口（item_search_img / 拍立淘） 的完整可用信息，含官方入口、参数、调用地址、返回字段、接入步骤和常见坑，可直接对接开发。

一、接口名称 & 用途

官方名称 ：1688 图片搜索 API（俗称：拍立淘 / 以图搜货）
接口标识 ：1688.item_search_img
作用：传一张图片（URL/Base64），返回 1688 平台同款 / 相似 B2B 商品（商品 ID、标题、价格、主图、供应商、起批量等）

适用场景：选品、比价、找同款货源、ERP 对接、批量搜款

二、核心参数（直接复制用）

公共参数（所有接口都要）

method=1688.item_search_img
app_key=你的KEY
timestamp=当前秒级时间戳
v=2.0
sign_method=md5
sign=签名（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等核心字段的深度分析，以及健壮的代码实践，可以帮你搭建高效的选品和采购工具。