?

一、接口功能概述

拼多多開放平臺提供的商品搜索API（pdd.ddk.goods.search）支持通過關鍵詞獲取商品列表，返回數據包含商品ID、標題、價格、銷量等核心信息。適用于比價工具、選品分析等場景。

二、調用前準備

平臺注冊
在拼多多開放平臺完成開發者認證，創建應用獲取client_id和client_secret。

權限申請
在控制臺申請API商品接口權限，特別注意：

個人開發者每日限額2000次

企業認證可提升至10萬次/日

三、API請求構建

核心請求參數示例：

GET /api/router?type=pdd.ddk.goods.search
  ?keyword=手機
  &page=1
  &page_size=50
  &sort_type=1
  &with_coupon=true
  &client_id=YOUR_CLIENT_ID
  ×tamp=1667890123
  &sign=生成的簽名

關鍵參數說明：

keyword：URL編碼后的搜索關鍵詞，如%E6%89%8B%E6%9C%BA

sort_type：排序方式（0-綜合 1-銷量 2-價格升序 3-價格降序）

with_coupon：是否返回優惠券信息

四、簽名生成算法

import hashlib

def generate_sign(params, secret):
    param_str = secret + ''.join(f'{k}{v}' for k,v in sorted(params.items()))
    return hashlib.md5(param_str.encode('utf-8')).hexdigest().upper()

五、響應數據處理

典型JSON響應結構：

{
  "goods_search_response": {
    "total": 1200,
    "goods_list": [
      {
        "goods_id": 123456789,
        "goods_name": "華為Mate60 5G手機",
        "min_group_price": 5999,
        "sales": 15234,
        "mall_name": "品牌旗艦店"
      }
    ]
  }
}

六、實戰示例（Python）

import requests
import urllib.parse
import time

def pdd_goods_search(keyword):
    base_url = "https://open-api.pinduoduo.com/api/router"
    params = {
        "type": "pdd.ddk.goods.search",
        "client_id": "YOUR_CLIENT_ID",
        "timestamp": int(time.time()),
        "keyword": urllib.parse.quote(keyword),
        "page_size": 20,
        "sort_type": 1
    }
    params["sign"] = generate_sign(params, "YOUR_CLIENT_SECRET")
    
    response = requests.get(base_url, params=params)
    return response.json()['goods_search_response']['goods_list']

# 調用示例
products = pdd_goods_search("藍牙耳機")
for p in products:
    print(f"{p['goods_name']} | 價格：{p['min_group_price']/100}元")

七、注意事項

頻率限制：單IP請求建議間隔≥500ms，避免觸發風控

數據更新：價格數據有效期為2小時，需定時刷新

字段差異：非旗艦店商品可能缺少mall_name字段

授權范圍：部分高敏感字段需額外申請權限

提示：實際開發請以最新版官方文檔為準，如有任何疑問，歡迎留言探討。

?審核編輯 黃宇