电商平台“图片搜索”接口获取数据全攻略

最新推荐文章于 2026-01-10 23:52:04 发布

原创最新推荐文章于 2026-01-10 23:52:04 发布 · 865 阅读

19 ·

CC 4.0 BY-SA版权

文章标签：

#数据库

淘宝api 同时被 2 个专栏收录

29 篇文章

订阅专栏

api

11 篇文章

订阅专栏

——淘宝、天猫、1688、京东、拼多多对比与实战

一、背景：为什么需要“以图搜款”

直播带货、社交电商、比价工具、ERP 选品、供应链爬虫都离不开“看到一张图，就能找到同款/相似款”的能力。各家官方把这项能力叫“拍立淘”“图搜”“拍照购”，但对外开放程度、接口形态、收费模式差异巨大。下文把 5 个主流平台的官方通道（含需申请）、替代方案、数据字段、Python 示例一次汇总，方便技术选型。

二、接口地图速览

平台	官方接口名称	是否需要资质	是否直接传图	主要返回字段	免费额度	备注
淘宝/天猫	`item_search_img`（拍立淘）	阿里妈妈开发者 + 单独权限	否，需先拿 `material_id`	标题、价格、销量、店铺、详情页链接	0（按调用量计费）	仅支持淘宝/天猫商品池
1688	`item_search_img`	企业实名 + 店铺评分 ≥4.5	支持图片 URL 或上传	商品标题、价格、起批量、供应商、相似度	500 次/日（免费版）	B2B 属性，起订量字段完整
京东	`imageSearch`（联盟）	京东联盟 PID	支持直接上传 base64	SKU、主图、券后价、佣金比例	1 万次/日（联盟）	需申请“物料搜索”权限
拼多多	暂无公开图搜接口	——	——	——	——	只能用关键词搜索后人工筛选
阿里云视觉智能	`ProductSearch`	实名 + 按量付费	支持直接上传	商品 ID、类目、置信度、自定义属性	500 次/月（试用）	通用图像搜索，可关联自家商品库

三、核心接口详解与代码

1. 淘宝/天猫（拍立淘）

接口地址：https://api.taobao.com/imgsearch/item_search_img.do
调用前提

入驻阿里妈妈 → 创建媒体 → 申请 material_type=image 权限。
图片必须先调用 taobao.upload.image 得到 material_id，不能直接传本地文件。

请求示例（Python）

import requests

APP_KEY = '你的app_key'
APP_SECRET = '你的secret'
MATERIAL_ID = '上传后返回的material_id'

url = 'https://api.taobao.com/imgsearch/item_search_img.do'
params = {
    'app_key': APP_KEY,
    'app_secret': APP_SECRET,
    'material_id': MATERIAL_ID,
    'cat': '',          # 可选：类目ID
    'page': 1
}
r = requests.get(url, params=params)
for item in r.json()['items']['item']:
    print(item['title'], item['price'], item['detail_url'])

返回字段（JSON）
title price orginal_price sales num_iid nick pic_url detail_url is_tmall

2. 1688（阿里中文站）

接口地址：https://api-gw.onebound.cn/1688/item_search_img
特点

支持直接传图片 URL 或先用 upload_img 拿到 imgid。
返回供应商信息（公司名、诚信通年限、地区），适合做供应链爬虫。

代码片段

url = 'https://api-gw.onebound.cn/1688/item_search_img'
params = dict(
    key='你的key',
    imgid='http://example.com/sample.jpg',
    page=1,
    sort='sales_desc'   # 销量排序
)
data = requests.get(url, params=params).json()
for it in data['items']:
    print(it['title'], it['price'], it['match_rate'], it['company'])

免费版 500 次/日，超出需购买套餐。

3. 京东（联盟图搜）

接口：https://api.jd.com/routerjson（method = jd.union.open.goods.material.search）
传参方式：image_bytes 直接放 base64，无需预上传。
返回：SKU、主图、券后价、佣金、计划类型。
调用限额：1 万次/日（联盟账号）