实战代码解析：拼多多 item_search API 使用教程

关注

原创最新推荐文章于 2026-08-10 15:58:42 发布 621 阅读 AI 写同款· GEO 优化 ›

拼多多商品数据如何通过api接口获取在使用API接口时，需要按照规定的请求格式进行请求，通常是使用HTTP协议发送请求，在请求中包含所需的参数，通过API接口获取数据。需要注意的是，在使用API接口获取商品数据时，应遵守拼多多的规定，保证数据使用的合法性，并不泄露用户隐私信息。需要注意的是，拼多多开放平台对调用接口的频率和访问限制有一定要求，需要按照规定进行调用。首先需要注册一个拼多多开放平台的开发者账号，然后创建一个应用程序，获取应用程序的app_id和app_secret，以在API请求中进行身份验证。阅读详情

一、接口概述

拼多多的 item_search API 允许开发者通过关键词搜索商品列表。此接口支持多种参数，如价格区间、分类、排序方式等，帮助开发者精准获取所需商品信息。

二、申请与准备

注册开发者账号：访问拼多多开放平台，使用手机号注册账号。
创建应用：在开发者后台创建应用，填写应用信息并提交审核。
获取API密钥：审核通过后，获取key和secret，用于接口调用的身份验证。

三、接口参数

（一）公共参数

key：调用key，必须以GET方式拼接在URL中。
secret：调用密钥。
api_name：API接口名称，如item_search。
cache：是否调用缓存数据，默认yes。
result_type：返回数据格式，默认json。
lang：翻译语言，默认cn。
version：API版本。

（二）请求参数

q：关键词。
start_price 和 end_price：价格区间。
page：页码。
cat：分类ID。
discount_only：是否仅显示优惠商品。
sort：排序方式，如bid（商品价格）、sale（销量）。
page_size：每页商品数量。

四、实战代码

以下是一个使用Python调用拼多多 item_search API 的示例代码：

import requests

def search_products_by_keyword(keyword, api_key, api_secret):
    # 构造API请求URL
    url = "https://api.pinduoduo.com/item_search"
    params = {
        "key": api_key,
        "secret": api_secret,
        "q": keyword,
        "page": 1,
        "page_size": 10,
        "sort": "sale_desc"  # 按销量降序排序
    }

    # 发送HTTP请求
    response = requests.get(url, params=params)

    # 检查响应状态码
    if response.status_code == 200:
        # 解析JSON响应
        data = response.json()
        # 提取商品列表
        products = data.get("items", [])
        return products
    else:
        print(f"Error: {response.status_code} - {response.text}")
        return []

# 使用示例
api_key = "YOUR_API_KEY"  # 替换为你的API Key
api_secret = "YOUR_API_SECRET"  # 替换为你的API Secret
keyword = "女装"  # 替换为你要搜索的关键词
products = search_products_by_keyword(keyword, api_key, api_secret)
for product in products:
    print(product)  # 打印每个商品的信息

五、返回值说明

（一）商品列表

items：商品列表。
- title：商品标题。
- pic_url：商品图片URL。
- price：商品价格。
- promotion_price：优惠价格。
- sales：销量。
- num_iid：商品ID。
- detail_url：商品详情页链接。