item_search-按关键字搜索商品
此API可通过传入关键字,搜索某一类商品,批量返回商品ID列表,支持翻页显示。
请求示例(PHP) 获取调用key测试工具
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://wx-15870092527/jd/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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版本 |
请求参数
请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&seller_info=no&nick=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明:q:搜索关键字,支持url
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_review,_new]
(bid:总价,sale:销量,review评论数,new新品,加_前缀为从大到小排序)<
page:
响应参数
| 名称 | 类型 | 是否隐私 | 示例值 | 描述 |
|---|---|---|---|---|
| items | items[] | 按关键字搜索商品 | ||
| num_iid | Bigint | 10021415166448 | 宝贝ID | |
| detail_url | String | item.jd.com/10021415166… | 商品详情页 | |
| title | String | 俞兆林2件装半高领打底衫秋冬长袖洋气纯色内衣内搭上衣黑色薄款女士秋衣女春秋保暖内衣女针织衫 黑色+浅卡其(80-130斤) | 商品标题 | |
| pic_url | String | //img13.360buyimg.com/n7/jfs/t1/115150/13/17438/307259/5f58be2fE727cfb0d/aa76563060a56420.png | 宝贝图片 | |
| price | Float | 188 | 价格 | |
| promotion_price | Float | 188 | 优惠价 | |
| sales | Int | 销量 | ||
| sample_id | Bigint | 商品风格标识ID | ||
| post_fee | Float | 物流费用 | ||
| area | String | 店铺所在地 | ||
| seller | String | 俞兆林YZL旗舰店 | 卖家昵称 |