Open Claw 封装的 1688.item_search_img(按图搜款) 接口,是 1688 官方拍立淘能力的标准化输出,无需企业资质、无需复杂权限,拿到 Key 即可调用,5 分钟就能实现 “图片→同款货源→全量数据” 的全自动选品,效率比手动翻页提升 10 倍以上。
一、核心优势:为什么选 Open Claw 做图片选品
零门槛接入:不用对接 1688 开放平台、不用申请应用、不用处理签名 / Token,注册即得 Key+Secret。
全字段返回:一次请求拿到标题、主图、价格、销量、库存、一件代发、店铺回头率、详情链接等选品全数据。
稳定合规:官方授权封装,无爬虫风险、无反爬拦截、数据实时同步 1688 平台。
多场景适配:支持网络图片 / 本地图片(转 URL)、淘宝 / 抖音 / 小红书爆款图搜同款、批量选品 + 货源监控。
二、接口核心信息(直接套用)
1. 基础信息
接口名称:1688 按图搜索商品(item_search_img)
请求地址:https://api-gw.onebound.cn/1688/item_search_img
请求方式:GET/POST
返回格式:JSON
2. 核心参数(必填 + 常用)
表格
| 参数名 | 是否必填 | 说明 |
|---|---|---|
| key | 是 | Open Claw 调用密钥(注册获取) |
| secret | 是 | 接口密钥(与 key 配对) |
| api_name | 是 | 固定值:item_search_img |
| imgid | 是 | 商品图片 URL(支持阿里图床 / 网络图片 / 跨平台图片) |
| sort | 否 | 排序:_sale(销量降序)、bid2(价格排序) |
| page | 否 | 页码(默认 1),分页获取更多结果 |
3. 选品必看字段(直接用)
title:商品标题(可直接用于铺货标题优化)
pic_url:商品主图(可下载用于店铺装修)
price/promotion_price:原价 / 促销价(快速比价)
sales:30 天销量(判断爆款潜力)
num_iid:商品 ID(用于后续详情查询 / 监控)
one_psale:是否一件代发(无货源卖家核心)
turn_head:店铺回头率(筛选优质供应商)
detail_url:商品详情页(一键核对货源)
三、5 分钟实战:从注册到选品全流程
步骤 1:注册获取调用凭证(3 分钟)
访问 Open Claw 官网注册账号
登录后进入控制台→我的密钥,复制 Key 和 Secret(妥善保管,勿泄露)
确认 1688.item_search_img 接口状态为正常(默认开通)
步骤 2:准备图片 URL(2 分钟)
网络图片:直接复制图片链接(如抖音 / 淘宝爆款图)
本地图片:上传至阿里云 OSS / 免费图床,生成公网可访问 URL
格式要求:支持 JPG/PNG,建议尺寸 500×500px 以上,相似度更高
步骤 3:代码调用(Python 示例,复制即用)
1)安装依赖
bash
运行
pip install requests openpyxl # openpyxl用于导出Excel
2)完整代码(替换 Key/Secret/ 图片 URL)
python
运行
import requests
import openpyxl
from datetime import datetime
# 1. 配置核心参数(替换为你自己的)
API_KEY = "你的Key"
API_SECRET = "你的Secret"
IMG_URL = "https://example.com/your-image.jpg" # 替换为目标图片URL
API_URL = "https://api-gw.onebound.cn/1688/item_search_img"
def image_search_1688():
"""按图搜索1688同款商品"""
params = {
"key": API_KEY,
"secret": API_SECRET,
"api_name": "item_search_img",
"imgid": IMG_URL,
"sort": "_sale", # 按销量排序
"page": "1"
}
try:
# 发送请求
response = requests.get(API_URL, params=params, timeout=10)
data = response.json()
if data.get("code") == 200:
items = data.get("result", {}).get("items", [])
print(f"✅ 搜索成功,找到 {len(items)} 款相似商品")
return items
else:
print(f"❌ 请求失败:{data.get('msg')}")
return []
except Exception as e:
print(f"❌ 网络异常:{str(e)}")
return []
def export_to_excel(items):
"""导出选品数据到Excel"""
if not items:
return
wb = openpyxl.Workbook()
ws = wb.active
ws.title = "1688图片选品结果"
# 表头
headers = ["商品标题", "价格", "销量", "是否一件代发", "店铺回头率", "商品链接", "主图链接"]
ws.append(headers)
# 写入数据
for item in items:
row = [
item.get("title", ""),
item.get("price", ""),
item.get("sales", "0"),
"是" if item.get("one_psale") else "否",
item.get("turn_head", "0%"),
item.get("detail_url", ""),
item.get("pic_url", "")
]
ws.append(row)
# 保存文件
filename = f"1688图片选品_{datetime.now().strftime('%Y%m%d_%H%M%S')}.xlsx"
wb.save(filename)
print(f"
审核编辑 黄宇
-
API
+关注
关注
2文章
2467浏览量
66995
发布评论请先 登录
用 OpenClaw 对接 1688 接口,快速实现图片选品妈妈再也不用担心了
电商效率翻倍:用 OpenClaw 对接 1688 接口,快速实现图片选品 + 货源监控
1688图搜接口选品的好帮手
1688图片搜索API(拍立淘)实操指南
1688商品列表API接口快速上手指南
1688商品详情API接口使用指南
1688接入API
1688品类API:市场趋势分析,选品更精准!
1688店铺详情API使用指南
国内电商 API 深度赋能:从选品、库存到履约,重构电商运营效率新范式
按图搜索1688商品API接口技术实现指南
电商效率翻倍:用 Open Claw 对接 1688 接口,快速实现图片选品
评论