淘宝图片搜索 API / item_search_img-search 淘宝商品图片搜索（拍立淘）/图片搜索 API 调用值说明

为了进行淘宝的API开发，首先我们需要做下面几件事情。

1）开发者注册一个账号

2）然后为每个淘宝应用注册一个应用程序键（App Key) 。

3）下载淘宝API的SDK并掌握基本的API基础知识和调用

4）利用SDK接口和对象，传入AppKey或者必要的时候获取并传入SessionKey来进行程序开发。

5）利用淘宝平台的文档中心和API测试工具，对接口进行测试。从而了解返回信息，方便程序获取。

以上是一般淘宝API应用开发的关键流程，其中通过淘宝文档中心和API测试工具，进行概念了解和接口信息查询很重要。因为这些数据就是我们需要在逐步显示出来的。淘宝的API很多，不过都分为了好几个领域，慢慢就会了解深入了。

淘宝/天猫按图搜索淘宝商品（拍立淘） API 返回值说明

item_search_img-按图搜索淘宝商品（拍立淘）

公共参数

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：imgid=g-search3.alicdn.com/img/bao/upl…

参数说明：imgid:图片地址（支持淘宝或天猫图片地址，外部地址先调用上传图片(upload_img)接口，返回图片地址）
如:img.alicdn.com/imgextra/i3…

响应参数

Version: Date:

名称	类型	必须	示例值	描述
title	String	0	亲子装短袖t恤社会人衣服全家装一家三口母子母女纯棉夏装上衣潮	宝贝标题
cid	Int	0	50015374
list_type	String	0	外观相似宝贝	列表类型
pic_url	String	0	//g-search3.alicdn.com/img/bao/uploaded/i4/TB26ry1rBsmBKNjSZFsXXaXSVXa_!!2628705716.jpg	宝贝图片
promotion_price	String	0	38.71	优惠价
price	Float	0	39.50	价格
sales	Int	0	7	销量
num_iid	Bigint	0	575727312808	宝贝ID
sample_id	Bigint	0	1627115368	商品风格标识ID
seller_nick	String	0	专属味道之dzw	掌柜昵称
is_tmall	Bool	0	false
post_fee	String	0	0.00	物流费用
area	String	0	广东 东莞	店铺所在地
detail_url	String	0	//item.taobao.com/item.htm?id=575727312808&ns=1#detail	宝贝链接

请求示例

Curl PHP PHPsdk JAVA C# Python

"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.onebound.cn/taobao/item_search_img/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&imgid=http://g-search3.alicdn.com/img/bao/uploaded/i4/O1CN01IDpcD81zHbpHs1YgT_!!2200811456689.jpg&cat="
headers = {
    "Accept-Encoding": "gzip",
    "Connection": "close"
}
if __name__ == "__main__":
    r = requests.get(url, headers=headers)
    json_obj = r.json()
    print(json_obj)

淘宝/天猫 API 按图搜索淘宝商品（拍立淘）接口数据演示

获取Key和secret测试