京東的關鍵詞搜索商品列表數據接口(JD.item_search)是京東開放平臺提供的重要 API 接口之一,以下是具體介紹:
注冊與認證
需在京東開放平臺注冊賬號并創建應用,創建時要選合適的權限范圍以便調用 API 接口,成功后會生成 API 密鑰,即 App Key 和 App Secret,用于后續的 API 調用和身份驗證.
請求參數
- keyword:必填的搜索關鍵詞.
- category_id:可選參數,通過指定商品分類 ID,可將搜索范圍限制在特定分類下的商品.
- price_min、price_max:可選的價格范圍參數,用于指定搜索商品的價格區間.
- brand:可選的品牌名稱或 ID 參數,可搜索特定品牌的商品.
- page、size:分頁參數,用于指定返回結果的頁碼和每頁顯示的商品數量.
- 公共參數:如 app_key、timestamp、sign 等,用于身份驗證和請求驗證.
請求格式
支持 GET 和 POST 兩種請求方式。若請求參數少,可用 GET 方式;若參數多或包含敏感信息,建議用 POST 方式,且需按京東開放平臺要求進行參數編碼和請求簽名.
請求示例
# coding:utf-8
demo url=c0b.cc/R4rbK2 wechat id:Taobaoapi2014
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請求示例 url 默認請求參數已經做URL編碼
url = "api-gw.Taobaoapi2014.cn/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)
響應內容
接口返回 JSON 格式的數據包,包含以下主要部分 :
- code:返回碼,表示請求處理的結果狀態。
- message:對返回碼進行解釋說明的返回信息。
- data:搜索結果數據,包含商品列表。每個商品對象包含商品的 ID、名稱、價格、圖片、庫存數量、銷量、評價數量、評分、配送地區、運費、促銷活動等詳細信息 。
應用場景
- 電商應用:為用戶提供實時、準確的商品搜索功能,提高用戶體驗和交易轉化率.
- 價格比較工具:幫助用戶快速找到同款商品在不同平臺上的價格差異.
- 市場分析工具:獲取大量商品數據進行分析和挖掘,了解市場趨勢、競爭態勢等信息.