淘宝关键词搜索API接口允许开发者通过关键词检索商品,并返回符合条件的商品信息,这些信息通常以JSON格式呈现。以下是一个淘宝关键词搜索API接口返回的JSON数据示例及关键字段说明:
JSON数据示例
json { "items": [ { "title": "时尚连衣裙", "price": "199.00", "image_url": "https://img.taobao.com/bao/uploaded/i1/XXX.jpg", "detail_url": "https://item.taobao.com/item.htm?id=XXXXXX", "sales_volume": 1000, "rating_count": 500, "num_iid": "123456789", "seller_nick": "卖家昵称", "is_tmall": "false", "area": "浙江 杭州" }, { "title": "高品质运动鞋", "price": "299.00", "image_url": "https://img.taobao.com/bao/uploaded/i2/YYY.jpg", "detail_url": "https://item.taobao.com/item.htm?id=YYYYYY", "sales_volume": 800, "rating_count": 450, "num_iid": "987654321", "seller_nick": "另一卖家昵称", "is_tmall": "true", "area": "广东 广州" } ], "status_code": "0000", "pagination": { "total_items": 10000, "current_page": 1, "per_page": 20 } }
关键字段说明
- items:一个数组,包含了多个商品对象。
- title:商品标题,包含品牌、型号、功能等关键词。
- price:商品价格(单位:元)。
- image_url:商品主图URL,支持点击跳转至详情页。
- detail_url:商品详情页链接,用户可以通过这个URL查看更多商品信息。
- sales_volume(可选):商品销量,反映商品热度。
- rating_count(可选):商品评价数量,用于评估商品口碑。
- num_iid:商品唯一标识ID,用于后续详情查询或订单关联。
- seller_nick:卖家昵称,支持点击跳转至店铺主页。
- is_tmall:是否为天猫商品(true/false),天猫商品通常享受更高服务保障。
- area:发货地区,帮助用户评估物流时效。
- status_code:状态码,用于表示请求的结果。例如,“0000”表示请求成功。
- pagination:分页信息,包含以下字段:
- total_items:总商品数。
- current_page:当前页码。
- per_page:每页显示的商品数量。