淘寶開(kāi)放平臺(tái)提供的高級(jí)關(guān)鍵字搜索商品接口，支持通過(guò)多種條件精準(zhǔn)篩選商品，并返回結(jié)構(gòu)化數(shù)據(jù)。以下是該接口的詳細(xì)說(shuō)明和使用指南：
一、接口核心功能與參數(shù)
1. 基礎(chǔ)參數(shù)
q（必填）：搜索關(guān)鍵詞，支持中文、英文及組合查詢(xún)（如 “夏季連衣裙 顯瘦”）。page（可選）：頁(yè)碼，默認(rèn)第 1 頁(yè)，建議分頁(yè)循環(huán)調(diào)用以獲取全部結(jié)果。page_size（可選）：每頁(yè)返回商品數(shù)，默認(rèn) 20，最大值通常為 100。
2. 高級(jí)篩選條件
- 價(jià)格區(qū)間：
- 排序方式：
- 過(guò)濾條件：
- 類(lèi)目與品牌：
3. 其他參數(shù)
cache（必選）：是否使用緩存，默認(rèn)yes，提高響應(yīng)速度。lang（可選）：返回結(jié)果語(yǔ)言，默認(rèn)cn（簡(jiǎn)體中文），可選en（英文）。
二、接口調(diào)用流程
1. 認(rèn)證與簽名
- 申請(qǐng) App Key 和 App Secret：在淘寶三方平臺(tái)（https://open.taobao.com）注冊(cè)并創(chuàng)建應(yīng)用，獲取
app_key和app_secret。
2. 請(qǐng)求示例（Python）
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(shù)已經(jīng)做URL編碼
# 封裝好API供應(yīng)商demo url=o0b.cn/ibrad
url = "https://api-gw.淘寶.cn/taobao/item_search_pro/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=蘋(píng)果17&page=1&sort=&page_size="
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
Copy三、返回結(jié)果解析
1. 核心字段說(shuō)明
- 商品信息：
- 賣(mài)家信息：
- 分頁(yè)信息：
2. 示例響應(yīng)數(shù)據(jù)
四、注意事項(xiàng)與最佳實(shí)踐
1. 頻率限制與反爬
- 調(diào)用頻率：普通應(yīng)用默認(rèn) QPS（每秒請(qǐng)求數(shù)）為 1-5，超出限制會(huì)返回錯(cuò)誤碼
4000或4013。如需更高配額，需提交工單申請(qǐng)。 - 反爬策略：
2. 數(shù)據(jù)合規(guī)與安全
- 隱私保護(hù)：接口返回的地址、手機(jī)號(hào)等敏感信息已模糊化（如
138****1234）。若需明文數(shù)據(jù)，需入駐聚石塔并申請(qǐng) R2 權(quán)限。 - 數(shù)據(jù)存儲(chǔ)：對(duì)用戶(hù)數(shù)據(jù)進(jìn)行加密傳輸（HTTPS）和存儲(chǔ)（如 AES 算法），遵守《網(wǎng)絡(luò)安全法》及平臺(tái)規(guī)定。
3. 分頁(yè)與性能優(yōu)化
- 分頁(yè)邏輯：根據(jù)
total_results和page_size計(jì)算總頁(yè)數(shù)，循環(huán)調(diào)用獲取全部數(shù)據(jù)。例如： - 字段篩選：通過(guò)
fields參數(shù)指定返回字段（如fields=num_iid,title,price），減少冗余數(shù)據(jù)傳輸。
五、錯(cuò)誤處理與調(diào)試
1. 常見(jiàn)錯(cuò)誤碼
| 狀態(tài)代碼(error_code) | 狀態(tài)信息 | 詳細(xì)描述 | 是否收費(fèi) |
|---|---|---|---|
| 0000 | success | 接口調(diào)用成功并返回相關(guān)數(shù)據(jù) | 是 |
| 2000 | Search success but no result | 接口訪問(wèn)成功，但是搜索沒(méi)有結(jié)果 | 是 |
| 4000 | Server internal error | 服務(wù)器內(nèi)部錯(cuò)誤 | 否 |
| 4001 | Network error | 網(wǎng)絡(luò)錯(cuò)誤 | 否 |
| 4002 | Target server error | 目標(biāo)服務(wù)器錯(cuò)誤 | 否 |
| 4003 | Param error | 用戶(hù)輸入?yún)?shù)錯(cuò)誤 | 忽略 |
| 4004 | Account not found | 用戶(hù)帳號(hào)不存在 | 忽略 |
| 4005 | Invalid authentication credentials | 授權(quán)失敗 | 忽略 |
| 4006 | API stopped | 您的當(dāng)前API已停用 | 忽略 |
| 4007 | Account stopped | 您的賬戶(hù)已停用 | 忽略 |
| 4008 | API rate limit exceeded | 并發(fā)已達(dá)上限 | 忽略 |
| 4009 | API maintenance | API維護(hù)中 | 忽略 |
| 4010 | API not found with these values | API不存在 | 忽略 |
| 4012 | Please add api first | 請(qǐng)先添加api | 忽略 |
| 4013 | Number of calls exceeded | 調(diào)用次數(shù)超限 | 忽略 |
| 4014 | Missing url param | 參數(shù)缺失 | 忽略 |
| 4015 | Wrong pageToken | 參數(shù)pageToken有誤 | 忽略 |
| 4016 | Insufficient balance | 余額不足 | 忽略 |
| 4017 | timeout error | 請(qǐng)求超時(shí) | 否 |
2. 調(diào)試工具
- 淘寶開(kāi)放平臺(tái)調(diào)試工具：在API 控制臺(tái)直接測(cè)試接口參數(shù)，查看返回結(jié)果。
- 通過(guò)合理使用item_search_pro接口，開(kāi)發(fā)者可高效獲取淘寶商品數(shù)據(jù)，支持電商選品、價(jià)格監(jiān)控、競(jìng)品分析等場(chǎng)景。實(shí)際業(yè)務(wù)需求，靈活調(diào)整參數(shù)和調(diào)用策略。
