一、引言 1688 平台提供的图片搜索 API 允许开发者通过上传商品图片来搜索平台上的同款或相似商品,该功能广泛应用于电商选品、价格比对等场景。通过 API 可以快速获取商品列表及相关信息,大幅提升采购效率。
二、接口概述
核心功能
同款/相似搜索:支持按同款或相似两种模式进行图片搜索。多维度数据返回:包括商品标题、价格区间、起订量、供应商信息等。图片格式支持:接受 JPG/PNG 格式的图片文件。
2.返回数据接口返回 JSON 格式数据,包含商品列表及详细信息,典型字段包括:
商品标题(subject)价格范围(price.min/max)起订量(minOrderQuantity)供应商信息(seller.companyName)图片相似度(similarity)
三、Python 请求示例
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "
app_key = "YOUR_APP_KEY" img id = "图片地址" # 目标图片地址
# 请求示例 url 默认请求参数已经做URL编码
url = "1688/item_search_img/?key=<您自己的apiKey>&图片地址"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
复制代码
该示例展示了完整的签名生成和 API 调用流程,包含错误处理机制,适用于生产环境集成。
评论