?

一、接口功能概述

拼多多開(kāi)放平臺(tái)提供的商品搜索API（pdd.ddk.goods.search）支持通過(guò)關(guān)鍵詞獲取商品列表，返回?cái)?shù)據(jù)包含商品ID、標(biāo)題、價(jià)格、銷量等核心信息。適用于比價(jià)工具、選品分析等場(chǎng)景。

二、調(diào)用前準(zhǔn)備

平臺(tái)注冊(cè)
在拼多多開(kāi)放平臺(tái)完成開(kāi)發(fā)者認(rèn)證，創(chuàng)建應(yīng)用獲取client_id和client_secret。

權(quán)限申請(qǐng)
在控制臺(tái)申請(qǐng)API商品接口權(quán)限，特別注意：

個(gè)人開(kāi)發(fā)者每日限額2000次

企業(yè)認(rèn)證可提升至10萬(wàn)次/日

三、API請(qǐng)求構(gòu)建

核心請(qǐng)求參數(shù)示例：

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

關(guān)鍵參數(shù)說(shuō)明：

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

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

with_coupon：是否返回優(yōu)惠券信息

四、簽名生成算法

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

五、響應(yīng)數(shù)據(jù)處理

典型JSON響應(yīng)結(jié)構(gòu)：

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

六、實(shí)戰(zhàn)示例（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']

# 調(diào)用示例
products = pdd_goods_search("藍(lán)牙耳機(jī)")
for p in products:
    print(f"{p['goods_name']} | 價(jià)格：{p['min_group_price']/100}元")

七、注意事項(xiàng)

頻率限制：?jiǎn)蜪P請(qǐng)求建議間隔≥500ms，避免觸發(fā)風(fēng)控

數(shù)據(jù)更新：價(jià)格數(shù)據(jù)有效期為2小時(shí)，需定時(shí)刷新

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

授權(quán)范圍：部分高敏感字段需額外申請(qǐng)權(quán)限

提示：實(shí)際開(kāi)發(fā)請(qǐng)以最新版官方文檔為準(zhǔn)，如有任何疑問(wèn)，歡迎留言探討。

?審核編輯 黃宇