AI 对接 1688 图搜接口｜Open Claw 以图搜货实战

接口名称：1688.item_search_img

能力：传入图片 URL/Base64，AI 视觉匹配同款、相似货源，批量快速选品

一、基础请求参数

表格

参数	必填	说明
key	是	平台调用密钥
secret	是	密钥凭证
api_name	是	固定值：item_search_img
imgid	二选一	公网图片链接
imgbase64	二选一	图片 Base64 编码
sort	否	_sale 销量排序、bid2 价格排序
page/page_size	否	分页控制
filter	否	agent=1 仅一件代发货源

二、核心返回字段

• num_iid：商品 ID，可联动详情接口深挖数据
• title、pic_url、price、sales：基础货源信息
• min_num：最小起订量
• support_agent：是否支持一件代发
• seller_name、delivery_place：商家与发货信息

三、Python 调用示例

python

运行

import requests

API_KEY = "你的key"
API_SECRET = "你的secret"
IMG_URL = "待搜索图片公网链接"

def search_by_image():
    url = "https://api-gw.onebound.cn/1688/item_search_img"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_search_img",
        "imgid": IMG_URL,
        "sort": "_sale",
        "filter": "agent=1"
    }
    res = requests.get(url, params=params).json()
    if res.get("code") == 200:
        goods = res["result"]["items"]
        print(f"匹配到{len(goods)}款货源")
        for item in goods[:5]:
            print(f"品名：{item['title']} 价格：{item['price']} 销量：{item['sales']}")
    else:
        print("查询失败", res.get("msg"))

search_by_image()

四、AI 联动用法

1. 图搜 + 详情联动 ：拿到商品 ID 后调用item_get，抓取 SKU、阶梯价、资质全量数据
2. AI 智能筛选：按起批量、价格、回头率自动过滤优质货源
3. 跨平台溯源：抖音 / 小红书爆款图，一键查找 1688 源头工厂货
4. 批量识图选品：多张图片循环调用，批量挖掘潜力款

五、使用优势

• 免 1688 企业资质、无需爬虫反爬处理
• AI 视觉精准匹配，同款相似度高
• 支持网络图、本地图两种传入格式
• 搭配筛选条件，快速锁定可代发、高销量货源