?

一、接口概述

蝦皮平臺(tái)（Shopee）提供的關(guān)鍵詞搜索API接口允許開發(fā)者通過(guò)指定搜索詞獲取商品列表數(shù)據(jù)。該接口采用RESTful設(shè)計(jì)，返回JSON格式數(shù)據(jù)，支持分頁(yè)查詢和多種篩選條件。

二、認(rèn)證方式

調(diào)用接口需使用OAuth 2.0認(rèn)證，需提前申請(qǐng)API Key和Secret Key：

import requests

API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"

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

四、請(qǐng)求示例

def search_shopee(keyword, page=1):
    url = "https://api.shopee.com/v2/search/items"
    headers = {
        "Authorization": f"Bearer {API_KEY}:{SECRET_KEY}"
    }
    params = {
        "keyword": keyword,
        "page": page,
        "limit": 50
    }
    response = requests.get(url, headers=headers, params=params)
    return response.json()

五、響應(yīng)數(shù)據(jù)結(jié)構(gòu)

{
  "items": [
    {
      "item_id": 123456,
      "title": "無(wú)線藍(lán)牙耳機(jī)",
      "price": 199.00,
      "rating": 4.8,
      "shop_location": "深圳"
    }
  ],
  "total_count": 1500,
  "page_size": 50,
  "has_next_page": true
}

六、錯(cuò)誤處理

常見錯(cuò)誤碼：

400：請(qǐng)求參數(shù)錯(cuò)誤

401：認(rèn)證失敗

429：請(qǐng)求頻率超限

503：服務(wù)不可用

七、最佳實(shí)踐

請(qǐng)求頻率控制：建議不超過(guò)10次/秒

異常重試：使用指數(shù)退避算法

import time

def retry_search(keyword, retries=3):
    for i in range(retries):
        try:
            return search_shopee(keyword)
        except Exception:
            time.sleep(2 ** i)
    return None

八、注意事項(xiàng)

數(shù)據(jù)緩存周期建議≥1小時(shí)

商業(yè)用途需遵守平臺(tái)API協(xié)議

敏感字段需脫敏處理

技術(shù)總結(jié)：該接口適用于商品比價(jià)、市場(chǎng)分析等場(chǎng)景，通過(guò)合理參數(shù)配置和錯(cuò)誤處理機(jī)制，可構(gòu)建穩(wěn)定的數(shù)據(jù)采集系統(tǒng)。建議使用requests.Session()保持連接復(fù)用，提升請(qǐng)求效率。

?
審核編輯 黃宇