?

一、接口概述

蝦皮平臺（Shopee）提供的關鍵詞搜索API接口允許開發者通過指定搜索詞獲取商品列表數據。該接口采用RESTful設計，返回JSON格式數據，支持分頁查詢和多種篩選條件。

二、認證方式

調用接口需使用OAuth 2.0認證，需提前申請API Key和Secret Key：

import requests

API_KEY = "your_api_key"
SECRET_KEY = "your_secret_key"

三、請求參數

四、請求示例

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()

五、響應數據結構

{
  "items": [
    {
      "item_id": 123456,
      "title": "無線藍牙耳機",
      "price": 199.00,
      "rating": 4.8,
      "shop_location": "深圳"
    }
  ],
  "total_count": 1500,
  "page_size": 50,
  "has_next_page": true
}

六、錯誤處理

常見錯誤碼：

400：請求參數錯誤

401：認證失敗

429：請求頻率超限

503：服務不可用

七、最佳實踐

請求頻率控制：建議不超過10次/秒

異常重試：使用指數退避算法

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

八、注意事項

數據緩存周期建議≥1小時

商業用途需遵守平臺API協議

敏感字段需脫敏處理

技術總結：該接口適用于商品比價、市場分析等場景，通過合理參數配置和錯誤處理機制，可構建穩定的數據采集系統。建議使用requests.Session()保持連接復用，提升請求效率。

?
審核編輯 黃宇