拼多多关键词搜索商品API调用指南(2025年最新版)

一、注册与认证流程

  1. 注册开发者账号
    • 访问拼多多开放平台注册企业/个人账号,完成实名认证(需企业营业执照或个人身份证)。
    • 提交应用审核(通常1-3个工作日),审核通过后获取 App KeyApp Secret(密钥需严格保密)。
  2. 获取访问令牌(Token)
    • 通过OAuth2.0的 client_credentials流程获取Token,示例代码:
      pythonimport requestsdef get_access_token():    url = "https://api.pinduoduo.com/oauth/token"    params = {        "client_id": "YOUR_APP_KEY",        "client_secret": "YOUR_APP_SECRET",        "grant_type": "client_credentials"    }    response = requests.post(url, data=params)    if response.status_code == 200:        return response.json()["access_token"]    else:        raise Exception("Token获取失败")

二、核心API接口说明

接口名称 请求方式 功能描述 关键参数
pdd.goods.search GET 商品关键词搜索 keyword(关键词)、 page(页码)、 size(每页数量,默认10)、 sort(排序方式,如 sale_desc按销量降序)
item_search GET 商品列表搜索(支持价格区间) q(关键词)、 start_price/ end_price(价格区间)、 cat(分类ID)、 discount_only(仅显示优惠商品)
pdd.goods.detail.get GET 商品详情查询 goods_id(商品ID)、 field(返回字段,如 title,price,sales

三、调用步骤与示例代码

1. 构造搜索请求

pythonimport requestsdef search_goods(keyword, page=1, size=10):    token = get_access_token()  # 调用上述Token获取函数    url = "https://api.pinduoduo.com/api/goods/search"    headers = {        "Authorization": f"Bearer {token}",        "Content-Type": "application/json"    }    params = {        "keyword": keyword,        "page": page,        "size": size,        "sort": "sale_desc"  # 按销量降序    }    response = requests.get(url, headers=headers, params=params)    return response.json() if response.status_code == 200 else None

2. 解析响应数据

  • 成功响应示例(JSON):
    json{  "items": [    {      "num_iid": "123456789",      "title": "智能手机",      "price": 1999.00,      "sales": 5000,      "pic_url": "https://img.pinduoduo.com/123.jpg",      "detail_url": "https://mobile.yangkeduo.com/goods1.html?goods_id=123456789"    }  ]}

四、注意事项与最佳实践

  1. 频率限制
    • 商品搜索接口限流: 3000次/60秒(商家权限),超限将临时封禁。
    • 建议使用限流策略(如 time.sleep(0.02)控制每秒50次请求)。
  2. 错误处理
    • 常见错误码:
      • 400:参数错误(如缺失 keyword
      • 401:Token无效或过期
      • 429:请求频率过高
    • 建议添加重试机制和日志记录:
      pythonfor _ in range(3):  # 最多重试3次    response = search_goods("智能手机")    if response:        break    else:        time.sleep(1)  # 等待1秒后重试
  3. 数据安全
    • 密钥存储:使用环境变量或加密存储(如 os.getenv("PDD_APP_SECRET")),避免硬编码。
    • 传输安全:所有请求必须通过HTTPS协议。
  4. 合规性要求
    • 禁止用于爬虫或恶意竞争,需遵守《拼多多开放平台用户协议》。
    • 未成年人禁止参与API相关交易。

五、应用场景示例

  • 电商选品分析:通过关键词搜索+销量排序,筛选热门商品。
  • 价格监控:定期调用 pdd.goods.detail.get跟踪竞品价格波动。
  • 智能推荐:结合用户历史行为,调用 item_search实现个性化商品推荐。

提示:建议定期查阅拼多多开放API文档获取最新接口规范,或通过拼多多API接口测试工具测试接口功能。


请使用浏览器的分享功能分享到微信等