一、接口基础介绍

接口名称：1688.item_search_img（1688 拍立淘 / 以图搜同款） 请求域名：https://api-gw.onebound.cn/1688/item_search_img 核心定位：依托图像识别 AI 算法，上传图片即可在 1688 平台匹配同款、高度相似批发货源，无需 1688 企业开发者资质，免签名、免爬虫，是无货源、跨境、AI 选品核心接口。

核心能力

1. 双图传参模式：支持公网图片 URL、本地图片 Base64 编码上传
2. AI 视觉匹配：精准识别服饰、家居、3C、美妆等全类目商品，区分版型 / 花纹 / 配色
3. 内置货源筛选：一键过滤一件代发、工厂商家、低起批量、高销量货源
4. 联动详情接口：返回商品 ID，可无缝调用1688.item_get抓取阶梯价、SKU、商家资质全量数据
5. 高并发稳定：适配批量识图、店群 ERP、AI 自动选品系统

二、完整请求参数说明

必传公共参数

表格

参数名	类型	必填	说明
key	string	✅	Open Claw 后台获取调用密钥
secret	string	✅	密钥配对凭证
api_name	string	✅	固定值：item_search_img
imgid	string	二选一	公网可直接访问的图片链接（推荐，无需转码）
imgbase64	string	二选一	本地图片 base64 编码，单张图片≤3MB

可选业务筛选参数（AI 选品核心）

表格

参数名	示例值	作用
sort	_sale	排序规则：_sale销量降序 / bid2价格升序 / credit诚信商家优先
page	1	分页页码，默认 1
page_size	20	单页返回商品数量，最大 50
filter	agent=1	货源过滤：agent=1仅展示支持一件代发商品；seller_type=factory仅工厂商家；delivery=义乌限定发货地
cache	no	是否读取缓存，no 为实时最新货源
lang	zh-CN	返回文案语言，跨境可切换 en

三、接口返回核心字段（AI 自动化处理可用）

json

{
  "code": 200,
  "msg": "success",
  "result": {
    "items": [
      {
        "num_iid": "679234561234",       // 商品唯一ID（联动详情接口关键）
        "title": "2026夏季纯棉宽松短袖女工厂批发",
        "pic_url": "https://g.alicdn.com/xxx.jpg", // 商品主图
        "price": "18.50",                // 基础批发价
        "agent_price": "22.00",          // 一件代发价
        "sales": "12680",                // 30天销量
        "min_num": "2",                  // 最小起批量MOQ
        "support_agent": true,           // 是否支持一件代发
        "seller_name": "XX服饰源头工厂",
        "seller_type": "factory",        // 商家类型：工厂/实力商家/普通
        "delivery_place": "浙江义乌",    // 发货地
        "turn_head": "4.9",              // 店铺回头率
        "detail_url": "商品1688原链接"
      }
    ]
  }
}

四、Python 完整调用代码（两种传图模式）

模式 1：网络图片 URL 调用（最简推荐）

python

运行

import requests

# 替换为你的Open Claw密钥
API_KEY = "你的key"
API_SECRET = "你的secret"
# 网络商品图片链接
IMAGE_URL = "https://xxx-test-product.jpg"

def search_1688_by_img_url():
    api_url = "https://api-gw.onebound.cn/1688/item_search_img"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_search_img",
        "imgid": IMAGE_URL,
        "sort": "_sale",
        "filter": "agent=1",  # 只保留一件代发货源
        "page_size": 30
    }
    resp = requests.get(api_url, params=params, timeout=25)
    res_data = resp.json()
    
    if res_data.get("code") == 200:
        goods_list = res_data["result"]["items"]
        print(f"AI识图匹配货源总数：{len(goods_list)}")
        # 打印前5款优质货源
        for idx, item in enumerate(goods_list[:5], 1):
            print(f"\n【货源{idx}】")
            print(f"标题：{item['title']}")
            print(f"代发价：{item['agent_price']} | 月销量：{item['sales']}")
            print(f"起批量：{item['min_num']} | 发货地：{item['delivery_place']}")
        return goods_list
    else:
        print(f"识图失败：{res_data.get('msg')} 错误码：{res_data.get('code')}")
        return None

if __name__ == "__main__":
    search_1688_by_img_url()

模式 2：本地图片 Base64 上传（本地素材批量识图）

python

运行

import requests
import base64

API_KEY = "你的key"
API_SECRET = "你的secret"
LOCAL_IMG_PATH = "local_product.jpg"

# 本地图片转base64工具函数
def img_to_base64(file_path):
    with open(file_path, "rb") as f:
        return base64.b64encode(f.read()).decode("utf-8")

def search_1688_by_local_img():
    img_b64 = img_to_base64(LOCAL_IMG_PATH)
    api_url = "https://api-gw.onebound.cn/1688/item_search_img"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_search_img",
        "imgbase64": img_b64,
        "sort": "_sale"
    }
    resp = requests.get(api_url, params=params, timeout=30)
    return resp.json()

search_1688_by_local_img()

五、AI 全链路联动实战（图搜→抓详情→AI 选品）

流程逻辑

1. 输入爆款图片（小红书 / 抖音 / 淘宝竞品图）调用item_search_img识图匹配货源
2. 循环提取返回的num_iid，调用1688.item_get抓取 SKU、阶梯价、详情图、商家资质全量数据
3. 接入大模型 AI 做智能筛选、数据分析、文案生成

联动抓取详情扩展代码片段

python

运行

# 根据图搜返回商品ID抓取完整货源信息
def get_1688_full_detail(num_iid):
    detail_url = "https://api-gw.onebound.cn/1688/item_get"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_get",
        "num_iid": num_iid
    }
    resp = requests.get(detail_url, params=params)
    return resp.json()["result"]

# 识图后批量抓取详情
goods = search_1688_by_img_url()
if goods:
    full_data_list = []
    for good in goods[:10]:
        detail = get_1688_full_detail(good["num_iid"])
        full_data_list.append(detail)
    # 送入AI模型做选品分析

六、AI 赋能四大落地业务场景

1. 无货源跨平台 AI 选品

小红书 / 抖音下载爆款种草图 → AI 图搜匹配 1688 源头工厂 → AI 自动计算铺货利润、筛选高销量低差评货源 → 一键导出上架素材，效率提升 10 倍以上。

2. 批量识图自动化铺货

本地存储海量竞品图片，循环 Base64 批量调用图搜接口，AI 自动清洗货源、过滤高起批量、无代发商品，生成标准化铺货 Excel 表格。

3. AI 竞品溯源比价

上传同行店铺商品图，AI 快速匹配多家 1688 供应商，自动对比代发价、发货时效、店铺评分，输出竞品货源成本分析报告。

4. AI 素材与文案生成

抓取匹配货源的标题、属性、详情图，投喂大模型自动生成跨境多语言 Listing、电商卖点、短视频带货文案。

七、接口核心优势

1. 零资质门槛：无需 1688 企业账号、无需开放平台认证，个人注册 Open Claw 即可调用
2. AI 视觉精准匹配：相比关键词搜索，跨平台同款识别准确率更高，解决 “有图找不到货源” 痛点
3. 一站式货源过滤：内置代发、工厂、发货地筛选参数，省去二次数据过滤开发
4. 低维护成本：平台封装反爬、签名、接口兼容逻辑，无需自行维护爬虫程序
5. 全链路打通：和 1688 详情、搜索、评论接口无缝联动，构建完整 AI 选品系统