以下是淘宝拍立淘按图搜索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)
