一、接口核心能力（拍立淘 + 詳情聯(lián)動）

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

支持圖片 URL/Base64兩種上傳方式，兼容淘寶、抖音、小紅書、本地商品圖，自動識別同款 / 相似款

精準(zhǔn)篩選：按銷量、價格、一件代發(fā)、實力商家、發(fā)貨地、起批量過濾，鎖定優(yōu)質(zhì)貨源

秒級響應(yīng)：1-2 秒返回匹配商品列表，含商品 ID、標(biāo)題、價格、主圖、店鋪、是否代發(fā)

免企業(yè)資質(zhì)、免登錄、免處理 1688 加密簽名，直接 HTTP 調(diào)用

2. 全量詳情抓取（聯(lián)動 1688.item_get）

拍立淘返回商品 ID → 自動調(diào)用詳情接口，一次性獲取50 + 字段：標(biāo)題、主圖、詳情圖、SKU、階梯批發(fā)價、代發(fā)價、MOQ、庫存、誠信通、發(fā)貨地、售后等 B2B 全量數(shù)據(jù)

實現(xiàn)圖搜→匹配→抓詳情→導(dǎo)出全流程自動化，效率提升 10 倍 +

二、接口基礎(chǔ)信息

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

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

請求方式：GET/POST（推薦 POST，支持 Base64）

返回格式：JSON

必傳參數(shù)

表格

常用可選參數(shù)（精準(zhǔn)篩選）

sort：排序（_sale 銷量降序、bid2 價格升序、credit 誠信優(yōu)先）

page：頁碼（默認(rèn) 1）

page_size：每頁條數(shù)（默認(rèn) 20，最大 50）

filter：過濾條件（支持：agent=1 僅一件代發(fā)、seller_type=factory 工廠、delivery = 義烏 發(fā)貨地）

cache：yes/no（默認(rèn) yes，緩存加速）

2. 商品詳情接口（1688.item_get，聯(lián)動用）

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

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

三、返回核心字段（選品 / 鋪貨直接用）

1. 拍立淘搜圖返回（匹配結(jié)果）

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

title：商品標(biāo)題

pic_url：商品主圖

price：批發(fā)價 / 代發(fā)價

min_num：最小起批量（MOQ）

sales：30 天銷量

seller_name：店鋪名稱

seller_type：實力商家 / 工廠 / 普通商家

support_agent：是否支持一件代發(fā)

delivery_place：發(fā)貨地

2. 詳情接口返回（全量數(shù)據(jù)）

基礎(chǔ)：標(biāo)題、主圖、輪播圖、詳情圖、視頻、類目、品牌

價格：代發(fā)價、階梯批發(fā)價、混批價、價格區(qū)間

SKU：完整規(guī)格、對應(yīng)價格、實時庫存、貨號

商家：誠信通年限、交易等級、好評率、發(fā)貨時效

交易：30 天銷量、總銷量、是否支持混批 / 代發(fā)

四、Python 實戰(zhàn)代碼（圖搜 + 抓詳情 + 導(dǎo)出，復(fù)制即用）

python

運行

import requests
import base64
import pandas as pd

# 替換為你的Open Claw密鑰
API_KEY = "你的key"
API_SECRET = "你的secret"

# 1. 本地圖片轉(zhuǎn)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"  # 僅篩選一件代發(fā)
    }
    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. 批量抓詳情并導(dǎo)出Excel
def batch_capture_and_export(img_url=None, img_path=None):
    # 1）圖片準(zhǔn)備
    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"),
                "標(biāo)題": detail.get("title"),
                "代發(fā)價": detail.get("agent_price"),
                "批發(fā)價": detail.get("batch_price"),
                "最小起批量": detail.get("min_num"),
                "主圖": detail.get("pic_url"),
                "發(fā)貨地": detail.get("delivery_place"),
                "商家": detail.get("seller_name"),
                "誠信通": detail.get("credit_level"),
                "是否代發(fā)": "是" if detail.get("support_agent") else "否"
            })
    # 4）導(dǎo)出Excel
    if all_data:
        df = pd.DataFrame(all_data)
        df.to_excel("1688拍立淘選品表.xlsx", index=False)
        print(f"? 已導(dǎo)出 {len(all_data)} 條商品數(shù)據(jù)到 1688拍立淘選品表.xlsx")

# 執(zhí)行：傳入圖片URL或本地圖片路徑
if __name__ == "__main__":
    # 方式1：用網(wǎng)絡(luò)圖片URL
    # batch_capture_and_export(img_url="https://example.com/product.jpg")
    # 方式2：用本地圖片
    batch_capture_and_export(img_path="your_product_image.jpg")

五、高頻電商場景落地

跨平臺同款溯源（無貨源核心）淘寶 / 抖音 / 小紅書看到爆款圖 → 拍立淘搜 1688 同款 → 抓代發(fā)價、起批量、商家資質(zhì) → 一鍵上架，解決 “有圖無貨源、找不到源頭” 問題

智能批量選品批量上傳競品 / 爆款圖片 → 自動匹配 1688 貨源 → 篩選一件代發(fā)、低起批量、高銷量、實力工廠 → 導(dǎo)出選品表，快速鎖定利潤款

貨源比價 & 風(fēng)控同一張圖搜多商家 → 對比代發(fā)價、起批量、發(fā)貨時效、誠信通 → 規(guī)避低質(zhì) / 高價商家，降低采購風(fēng)險

素材批量采集拍立淘匹配后，自動抓取主圖、詳情圖、SKU 圖、視頻，去水印整理，用于店鋪裝修 / 鋪貨

審核編輯 黃宇