AI 效率翻倍：对接 1688 拍立淘接口，商品全量信息一键抓取

一、接口核心能力（拍立淘 + 详情联动）

1. 拍立淘搜图核心（1688.item_search_img）

支持图片 URL/Base64两种上传方式，兼容淘宝、抖音、小红书、本地商品图，自动识别同款 / 相似款

精准筛选：按销量、价格、一件代发、实力商家、发货地、起批量过滤，锁定优质货源

秒级响应：1-2 秒返回匹配商品列表，含商品 ID、标题、价格、主图、店铺、是否代发

免企业资质、免登录、免处理 1688 加密签名，直接 HTTP 调用

2. 全量详情抓取（联动 1688.item_get）

拍立淘返回商品 ID → 自动调用详情接口，一次性获取50 + 字段：标题、主图、详情图、SKU、阶梯批发价、代发价、MOQ、库存、诚信通、发货地、售后等 B2B 全量数据

实现图搜→匹配→抓详情→导出全流程自动化，效率提升 10 倍 +

二、接口基础信息

1. 拍立淘搜图接口（1688.item_search_img）

请求地址：https://api-gw.onebound.cn/1688/item_search_img

请求方式：GET/POST（推荐 POST，支持 Base64）

返回格式：JSON

必传参数

表格

参数名	必填	说明
key	是	Open Claw 调用密钥
secret	是	接口密钥
api_name	是	固定值：item_search_img
imgid	是	商品图片 URL（公网可访问），与 imgbase64 二选一
imgbase64	是	图片 Base64 编码（≤3M），与 imgid 二选一

常用可选参数（精准筛选）

sort：排序（_sale 销量降序、bid2 价格升序、credit 诚信优先）

page：页码（默认 1）

page_size：每页条数（默认 20，最大 50）

filter：过滤条件（支持：agent=1 仅一件代发、seller_type=factory 工厂、delivery = 义乌 发货地）

cache：yes/no（默认 yes，缓存加速）

2. 商品详情接口（1688.item_get，联动用）

请求地址：https://api-gw.onebound.cn/1688/item_get

必传：key、secret、api_name=item_get、num_iid（拍立淘返回的商品 ID）

三、返回核心字段（选品 / 铺货直接用）

1. 拍立淘搜图返回（匹配结果）

num_iid：商品 ID（用于抓详情）

title：商品标题

pic_url：商品主图

price：批发价 / 代发价

min_num：最小起批量（MOQ）

sales：30 天销量

seller_name：店铺名称

seller_type：实力商家 / 工厂 / 普通商家

support_agent：是否支持一件代发

delivery_place：发货地

2. 详情接口返回（全量数据）

基础：标题、主图、轮播图、详情图、视频、类目、品牌

价格：代发价、阶梯批发价、混批价、价格区间

SKU：完整规格、对应价格、实时库存、货号

商家：诚信通年限、交易等级、好评率、发货时效

交易：30 天销量、总销量、是否支持混批 / 代发

四、Python 实战代码（图搜 + 抓详情 + 导出，复制即用）

python

运行

import requests
import base64
import pandas as pd

# 替换为你的Open Claw密钥
API_KEY = "你的key"
API_SECRET = "你的secret"

# 1. 本地图片转Base64（也可直接用图片URL）
def image_to_base64(image_path):
    with open(image_path, "rb") as f:
        return base64.b64encode(f.read()).decode("utf-8")

# 2. 1688拍立淘搜图（获取同款商品ID列表）
def search_1688_by_img(img_url=None, img_base64=None):
    url = "https://api-gw.onebound.cn/1688/item_search_img"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_search_img",
        "sort": "_sale",  # 按销量排序
        "page": 1,
        "page_size": 20,
        "filter": "agent=1"  # 仅筛选一件代发
    }
    if img_url:
        params["imgid"] = img_url
    elif img_base64:
        params["imgbase64"] = img_base64

    try:
        resp = requests.get(url, params=params, timeout=30)
        result = resp.json()
        if result.get("code") == 200:
            items = result.get("result", {}).get("items", [])
            print(f"拍立淘匹配到 {len(items)} 件商品")
            return [item["num_iid"] for item in items]  # 返回商品ID列表
        else:
            print(f"搜图失败：{result.get('msg')}")
            return []
    except Exception as e:
        print(f"搜图异常：{e}")
        return []

# 3. 抓取单个商品全量详情
def get_1688_detail(num_iid):
    url = "https://api-gw.onebound.cn/1688/item_get"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_get",
        "num_iid": num_iid
    }
    try:
        resp = requests.get(url, params=params, timeout=20)
        result = resp.json()
        if result.get("code") == 200:
            return result["result"]
        else:
            print(f"抓详情失败 {num_iid}：{result.get('msg')}")
            return None
    except Exception as e:
        print(f"详情请求异常 {num_iid}：{e}")
        return None

# 4. 批量抓详情并导出Excel
def batch_capture_and_export(img_url=None, img_path=None):
    # 1）图片准备
    img_base64 = image_to_base64(img_path) if img_path else None
    # 2）拍立淘搜同款
    item_ids = search_1688_by_img(img_url=img_url, img_base64=img_base64)
    if not item_ids:
        return
    # 3）批量抓详情
    all_data = []
    for iid in item_ids[:10]:  # 取前10个爆款
        detail = get_1688_detail(iid)
        if detail:
            all_data.append({
                "商品ID": detail.get("num_iid"),
                "标题": detail.get("title"),
                "代发价": detail.get("agent_price"),
                "批发价": detail.get("batch_price"),
                "最小起批量": detail.get("min_num"),
                "主图": detail.get("pic_url"),
                "发货地": detail.get("delivery_place"),
                "商家": detail.get("seller_name"),
                "诚信通": detail.get("credit_level"),
                "是否代发": "是" if detail.get("support_agent") else "否"
            })
    # 4）导出Excel
    if all_data:
        df = pd.DataFrame(all_data)
        df.to_excel("1688拍立淘选品表.xlsx", index=False)
        print(f"✅ 已导出 {len(all_data)} 条商品数据到 1688拍立淘选品表.xlsx")

# 执行：传入图片URL或本地图片路径
if __name__ == "__main__":
    # 方式1：用网络图片URL
    # batch_capture_and_export(img_url="https://example.com/product.jpg")
    # 方式2：用本地图片
    batch_capture_and_export(img_path="your_product_image.jpg")

五、高频电商场景落地

跨平台同款溯源（无货源核心）淘宝 / 抖音 / 小红书看到爆款图 → 拍立淘搜 1688 同款 → 抓代发价、起批量、商家资质 → 一键上架，解决 “有图无货源、找不到源头” 问题

智能批量选品批量上传竞品 / 爆款图片 → 自动匹配 1688 货源 → 筛选一件代发、低起批量、高销量、实力工厂 → 导出选品表，快速锁定利润款

货源比价 & 风控同一张图搜多商家 → 对比代发价、起批量、发货时效、诚信通 → 规避低质 / 高价商家，降低采购风险

素材批量采集拍立淘匹配后，自动抓取主图、详情图、SKU 图、视频，去水印整理，用于店铺装修 / 铺货

审核编辑 黄宇