以下是淘宝拍立淘按图搜索API接口返回的JSON数据示例及关键字段解析:
JSON数据示例
json { "items": { "page": 1, "page_size": 20, "total_results": 1500, "item": [ { "title": "2025夏季新款女装连衣裙修身显瘦气质裙子", "pic_url": "https://img.alicdn.com/bao/uploaded/i1/123456789/O1CN01abc123.jpg", "promotion_price": "129.00", "price": "199.00", "sales": 2560, "num_iid": "123456789", "seller_nick": "美丽衣橱旗舰店", "is_tmall": true, "area": "浙江 杭州", "detail_url": "https://item.taobao.com/item.htm?id=123456789", "similarity_score": 0.95 }, { "title": "夏季新款女装雪纺连衣裙中长款碎花裙子", "pic_url": "https://img.alicdn.com/bao/uploaded/i2/987654321/O1CN01xyz987.jpg", "promotion_price": "159.00", "price": "259.00", "sales": 1890, "num_iid": "987654321", "seller_nick": "时尚女装店", "is_tmall": false, "area": "广东 广州", "detail_url": "https://item.taobao.com/item.htm?id=987654321", "similarity_score": 0.92 } ] }, "request_id": "abc123xyz456" }
关键字段解析
- 商品基础信息
title
: 商品标题,包含品牌、型号、功能等关键词。pic_url
: 商品主图URL,支持点击跳转至详情页。price
: 商品原价(单位:元),promotion_price
为促销价(如有)。num_iid
: 商品唯一标识ID,用于后续详情查询或订单关联。
- 销售与评价数据
sales
: 30天销量,反映商品热度。similarity_score
: 图片相似度得分(0-1之间),得分越高匹配越精准。
- 商家与物流信息
seller_nick
: 卖家昵称,支持点击跳转至店铺主页。is_tmall
: 是否为天猫商品(true
/false
),天猫商品通常享受更高服务保障。area
: 发货地区,帮助用户评估物流时效。
- 分页与请求信息
total_results
: 匹配关键词的总商品数,用于计算总页数。page
/page_size
: 当前页码及每页显示数量,支持深度分页。request_id
: 请求唯一标识符,用于问题排查或日志追踪。
接口调用流程(Python示例)
python import requests def search_by_image(app_key, app_secret, img_url): url = "https://api.taobao.com/imgsearch/item_search_img.do" params = { "key": app_key, "secret": app_secret, "imgid": img_url, "page": 1, "page_size": 20 } response = requests.get(url, params=params) return response.json() # 示例调用 data = search_by_image("your_app_key", "your_app_secret", "https://example.com/image.jpg") if "error_response" in data: print(f"请求出错: {data['error_response']['msg']}") else: for item in data["items"]["item"]: print(f"商品标题: {item['title']}") print(f"价格: {item['price']}(促销价: {item.get('promotion_price', '无')})") print(f"销量: {item['sales']}") print(f"相似度: {item['similarity_score']}") print("-" * 50)