淘寶關(guān)鍵字搜索接口 API->item_search （實(shí)戰(zhàn)演示）

管理

編輯

刪除

鍵盤上的螞蟻 2025-06-18 11:58:07

暫不處理

淘寶關(guān)鍵字搜索接口 item_search 是一個(gè)強(qiáng)大的API，允許開發(fā)者通過關(guān)鍵詞搜索淘寶商品。以下是該接口的詳細(xì)解析：

基本功能

item_search API 允許您：

通過關(guān)鍵詞搜索淘寶/天貓商品
獲取商品列表及相關(guān)信息
支持多種排序和篩選條件

請(qǐng)求參數(shù)

q:搜索關(guān)鍵字

cat:分類ID

start_price:開始價(jià)格

end_price:結(jié)束價(jià)格

sort:排序[bid,bid,bid2,_bid2,_sale,_credit]

(bid:總價(jià),bid2:商品價(jià)格,sale:銷量,credit信用,加前綴為從大到小排序)

page:頁(yè)數(shù)

page_size:每頁(yè)寶貝數(shù)量，默認(rèn)40

seller_info:是否獲取商家信息[yes,no],默認(rèn)yes

API:item_get 參數(shù)說明: num_iid:寶貝ID

名稱	類型	必須	描述
key	String	是	調(diào)用key（必須以GET方式拼接在URL中）
secret	String	是	調(diào)用密鑰
api_name	String	是	API接口名稱（包括在請(qǐng)求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默認(rèn)yes，將調(diào)用緩存的數(shù)據(jù)，速度比較快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回?cái)?shù)據(jù)格式，默認(rèn)為json，jsonu輸出的內(nèi)容中文可以直接閱讀
lang	String	否	[cn,en,ru]翻譯語(yǔ)言，默認(rèn)cn簡(jiǎn)體中文
version	String	否	API版本

接口核心參數(shù)詳解

def search_taobao(keyword, page=1, sort="default"):
    """淘寶商品搜索API調(diào)用示例"""
    # 假設(shè) API 接口地址，復(fù)制鏈接獲取測(cè)試 
    前往體驗(yàn)API：o0b.cn/ibrad
    params = {
        "method": "item_search",
        "app_key": "YOUR_APP_KEY",
        "sign": generate_sign(params),  # 簽名生成函數(shù)
        "timestamp": get_current_time(),
        "format": "json",
        "v": "2.0",
        "keyword": keyword,  # 搜索關(guān)鍵詞（核心參數(shù)）
        "page_no": page,     # 頁(yè)碼
        "page_size": 20,     # 每頁(yè)數(shù)量（默認(rèn)20，最大100）
        "sort": sort,        # 排序方式：default（默認(rèn)）、price-asc（價(jià)格升序）、price-desc（價(jià)格降序）、sales（銷量）、credit（信用）
        "cat": "",           # 類目ID（可選）
        "start_price": 0,    # 價(jià)格區(qū)間-起始
        "end_price": 0,      # 價(jià)格區(qū)間-結(jié)束
        "is_tmall": False,   # 是否天貓商品
        "has_discount": False, # 是否有優(yōu)惠
        "source": "search"   # 搜索來源（固定值）
    }
    return request_api(params)

使用示例

import requests

def taobao_item_search(keyword, page=1, page_size=40):
    url = "https://api.taobao.com/router/rest"
    params = {
        "method": "taobao.item.search",
        "app_key": "YOUR_APP_KEY",
        "sign_method": "md5",
        "timestamp": "2023-01-01 00:00:00",
        "format": "json",
        "v": "2.0",
        "q": keyword,
        "page_no": page,
        "page_size": page_size
    }
    
    # 需要生成簽名(sign)
    # params['sign'] = generate_sign(params, "YOUR_APP_SECRET")
    
    response = requests.get(url, params=params)
    return response.json()

# 使用示例
result = taobao_item_search("手機(jī)", page=1)
print(result)

注意事項(xiàng)

認(rèn)證與授權(quán)：使用淘寶API需要先申請(qǐng)成為淘寶開放平臺(tái)開發(fā)者，創(chuàng)建注冊(cè)賬號(hào)獲取App Key和App Secret。
調(diào)用限制：淘寶API有調(diào)用頻率限制，需遵守平臺(tái)規(guī)則。
簽名機(jī)制：所有請(qǐng)求都需要按照淘寶規(guī)則生成簽名。
數(shù)據(jù)更新：商品數(shù)據(jù)可能有延遲，不是實(shí)時(shí)更新。
商業(yè)用途：大規(guī)模商業(yè)使用需要申請(qǐng)高級(jí)權(quán)限或付費(fèi)。