拼多多根据关键词取商品列表 API接口数据调用(内含详细步骤)

拼多多API,全称应用程序接口,是一种提供特定功能和服务的软件接口。对于拼多多平台而言,API是其对外开放的一种接口,允许开发者调用拼多多的商品信息、订单信息、物流信息等数据,以便在第三方平台上进行集成、扩展和创新。 

 

pinduoduo.item_search

公共参数

点击获取免费测试

名称类型必须描述
keyString调用key(必须以GET方式拼接在URL中)
secretString调用密钥
api_nameStringAPI接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]
cacheString[yes,no]默认yes,将调用缓存的数据,速度比较快
result_typeString[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读
langString[cn,en,ru]翻译语言,默认cn简体中文
versionStringAPI版本

请求参数

请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=

参数说明:q:关键词, sort:排序[bid,_bid,_sale,sale] (bid:商品价格,sale:销量,加_前缀为从大到小排序)

响应参数

Version: Date:

名称类型必须示例值描述

items

items[]0根据关键词取商品列表

 

响应示例

{
    "items":{
        "page":"10",
        "real_total_results":2000,
        "total_results":2000,
        "page_size":20,
        "pagecount":100,
        "_ddf":"eow",
        "item":[
            {
                "title":"牛胸肉50斤 巴西进口牛肉面馆用原切切片牛肉冷冻牛肉牛胸肉商用",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-28/b0254222-e8ba-4918-9a0f-6c316e8e5e72.jpeg",
                "promotion_price":"1097.8",
                "price":"1097.8",
                "sales":8,
                "num_iid":586280148663,
                "seller_id":117895202,
                "detail_url":"https://item.taobao.com/item.htm?id=586280148663"
            },
            {
                "title":"潮汕牛肉火锅食材吊龙嫩肉肥牛组合套餐",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-29/853b3645-db8f-4fe7-a37b-1c3181ab3df0.jpeg",
                "promotion_price":"47.6",
                "price":"47.6",
                "sales":16,
                "num_iid":586324736363,
                "seller_id":666613519,
                "detail_url":"https://item.taobao.com/item.htm?id=586324736363"
            },
            {
                "title":"李丫头牛肉 沈丘特产10包200G 另有沈丘李丫头牛腱  包邮【2月28日发完】",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-29/74f9b58f-28a3-4646-8e1c-d36a1a17838e.jpeg",
                "promotion_price":"386.44",
                "price":"386.44",
                "sales":11,
                "num_iid":586441874448,
                "seller_id":901836469,
                "detail_url":"https://item.taobao.com/item.htm?id=586441874448"
            },
            {
                "title":"湘当经典湘西牛肉风味丝408g大礼包湖南特产张家界景区同款素牛肉",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-28/23a1abd9-565a-4b12-abbc-858109a4bb8e.jpeg",
                "promotion_price":"36.5",
                "price":"36.5",
                "sales":2,
                "num_iid":586280069640,
                "seller_id":150283384,
                "detail_url":"https://item.taobao.com/item.htm?id=586280069640"
            },
            {
                "title":"玉林牛腊巴广西玉林特产香辣牛肉条麻辣牛巴传统手艺味道独特包邮",
                "pic_url":"https://t00img.yangkeduo.com/goods/images/2021-03-21/48d4a63a-ea96-4b61-a01e-088113ecf610.jpeg",
                "promotion_price":"58.4",
                "price":"58.4",
                "sales":0,
                "num_iid":585679909771,
                "seller_id":965132469,
                "detail_url":"https://item.taobao.com/item.htm?id=585679909771"
            },
            {
                "title":"大促销 生牛肉10斤",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-01/f1f83e65-9ae8-4106-9a45-6dc2e984bc0d.jpeg",
                "promotion_price":"430.02",
                "price":"430.02",
                "sales":1,
                "num_iid":576488968007,
                "seller_id":577575374,
                "detail_url":"https://item.taobao.com/item.htm?id=576488968007"
            },
            {
                "title":"酱卤牛肉熟食真空包装内蒙古特产零食营养休闲小吃即食下酒菜",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-25/aad85671-f6dc-46d2-8dec-9d0a831b14e0.jpeg",
                "promotion_price":"33",
                "price":"33",
                "sales":14,
                "num_iid":585527238777,
                "seller_id":335213461,
                "detail_url":"https://item.taobao.com/item.htm?id=585527238777"
            },
            {
                "title":"前后阿兰那腱子50斤,当天拍发货很快,海南偏远地区不发",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-06/437c7863-c314-43fe-9e3d-5de4413a93c5.jpeg",
                "promotion_price":"778",
                "price":"778",
                "sales":18,
                "num_iid":578236178968,
                "seller_id":136934121,
                "detail_url":"https://item.taobao.com/item.htm?id=578236178968"
            },
            {
                "title":"西牛优选黄牛牛排骨5斤黄牛草饲散养牛肋排牛排牛肉新鲜黄膘散养3",
                "pic_url":"https://img.pddpic.com/mms-material-img/2023-08-07/8dd5ba7c-4611-474b-85ee-ad784bcb316a.jpeg",
                "promotion_price":"104.69",
                "price":"104.69",
                "sales":300000,
                "num_iid":234200007672,
                "seller_id":869944360,
                "detail_url":"https://item.taobao.com/item.htm?id=234200007672"
            },
            {
                "title":"原切牛肉干牛肉粒网红吃货办公室即熟食零食休闲特色小吃休闲食品",
                "pic_url":"https://img.pddpic.com/mms-material-img/2021-07-19/25d93394-ea75-4b23-a93d-67cc9c09d0b5.png.a.jpeg",
                "promotion_price":"4.8",
                "price":"4.8",
                "sales":1000000,
                "num_iid":255631497340,
                "seller_id":529792881,
                "detail_url":"https://item.taobao.com/item.htm?id=255631497340"
            },
            {
                "title":"御牛满地澳洲安格斯牛排原切谷饲M3板腱雪花牛排健身减脂牡蛎肉",
                "pic_url":"https://img.pddpic.com/mms-material-img/2023-09-14/b5b3eba7-dbd8-47a7-b957-405d4e911292.jpeg",
                "promotion_price":"59",
                "price":"59",
                "sales":5435,
                "num_iid":528243175682,
                "seller_id":923098940,
                "detail_url":"https://item.taobao.com/item.htm?id=528243175682"
            },
            {
                "title":"巴西雪花牛肉原装进口大雪花烤肉涮肉牛尖峰牛肉火锅寿喜锅健身",
                "pic_url":"https://img.pddpic.com/mms-material-img/2023-05-15/f70ae76c-284f-4ade-9fcd-069c30827dce.jpeg",
                "promotion_price":"108",
                "price":"108",
                "sales":17000,
                "num_iid":482651563151,
                "seller_id":804788346,
                "detail_url":"https://item.taobao.com/item.htm?id=482651563151"
            },
            {
                "title":"真牛肉内蒙古正宗手撕风干牛肉干新鲜牛肉零食独立小包装无干燥剂",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-24/60cb16d7-a468-46c9-97df-d82a4a592da6.jpeg",
                "promotion_price":"9.9",
                "price":"9.9",
                "sales":13,
                "num_iid":585161165639,
                "seller_id":258613228,
                "detail_url":"https://item.taobao.com/item.htm?id=585161165639"
            },
            {
                "title":"牦牛肉青藏高原正品牦牛肉正宗清真牛肋骨里脊牛腩牛腱牛腿肉新鲜",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-12/babb0509-9470-4dab-8cb5-26488b26ac5a.jpeg",
                "promotion_price":"188",
                "price":"188",
                "sales":290,
                "num_iid":580689837817,
                "seller_id":690308329,
                "detail_url":"https://item.taobao.com/item.htm?id=580689837817"
            },
            {
                "title":"小炒黄牛肉嫩滑小炒牛肉200g/包生鲜免调理懒人菜新鲜原切牛肉片",
                "pic_url":"https://img.pddpic.com/mms-material-img/2023-07-25/1ea2b6ab-e249-4ac0-a8fd-a3ab1afc7ca0.png",
                "promotion_price":"29.3",
                "price":"29.3",
                "sales":1016,
                "num_iid":506249661178,
                "seller_id":314561002,
                "detail_url":"https://item.taobao.com/item.htm?id=506249661178"
            },
            {
                "title":"正宗内蒙古牛肉干独立包装手撕7成干即食50克休闲零食风干牛肉干",
                "pic_url":"https://img.pddpic.com/mms-material-img/2024-01-24/d1d85396-9baf-4d81-a630-6de31e505bde.jpeg",
                "promotion_price":"9.9",
                "price":"9.9",
                "sales":6,
                "num_iid":585143732343,
                "seller_id":326843543,
                "detail_url":"https://item.taobao.com/item.htm?id=585143732343"
            },
            {
                "title":"【小牛推荐】批发现称新鲜原切牛肋条一整箱农家散养黄牛肉零添加",
                "pic_url":"https://commimg.pddpic.com/ad-promotion/2023-12-27/7c978bc4-23f7-4b56-b325-1fbbee9084d3.jpeg",
                "promotion_price":"119.5",
                "price":"119.5",
                "sales":300000,
                "num_iid":258911037877,
                "seller_id":964996078,
                "detail_url":"https://item.taobao.com/item.htm?id=258911037877"
            },
            {
                "title":"宁夏正宗清真泾源新鲜小牛肉原切牛腱子牛腩牛里脊5/3/2/1斤包邮",
                "pic_url":"https://t00img.yangkeduo.com/goods/images/2020-03-27/0f31bb68-1c8b-4390-b11f-d952864b8780.jpg",
                "promotion_price":"121",
                "price":"121",
                "sales":1705,
                "num_iid":99158732108,
                "seller_id":910250516,
                "detail_url":"https://item.taobao.com/item.htm?id=99158732108"
            },
            {
                "title":"包邮批发新鲜正宗冷冻原切新鲜现杀鲜肉生鲜肉后新鲜生鲜肉一整箱",
                "pic_url":"https://img.pddpic.com/mms-material-img/2022-10-20/00e56ca0-d5f6-4d00-8ffe-6db4a99a97d4.jpeg",
                "promotion_price":"45.58",
                "price":"45.58",
                "sales":17000,
                "num_iid":424359929045,
                "seller_id":154153856,
                "detail_url":"https://item.taobao.com/item.htm?id=424359929045"
            },
            {
                "title":"希菲 4斤原切牛腩块0添加谷饲牛腩肉块卤肉炖煮食材生鲜年货礼盒",
                "pic_url":"https://img.pddpic.com/mms-material-img/2023-12-21/fc1c21a1-bdfd-4ac6-8186-c8aca38aefe3.png",
                "promotion_price":"85.49",
                "price":"85.49",
                "sales":28000,
                "num_iid":235553835351,
                "seller_id":508708250,
                "detail_url":"https://item.taobao.com/item.htm?id=235553835351"
            }
        ]
    },
    "error_code":"0000",
    "reason":"ok",
    "secache":"b904f63c1d1b6c539a40028cdff22e1f",
    "secache_time":1706756190,
    "secache_date":"2024-02-01 10:56:30",
    "translate_status":"",
    "translate_time":0,
    "language":{
        "default_lang":"cn",
        "current_lang":"cn"
    },
    "error":"",
    "cache":0,
    "api_info":"today: max:15000 all[=++];expires:2031-01-01",
    "execution_time":"0.45",
    "server_time":"Beijing/2024-02-01 10:56:30",
    "client_ip":"127.0.0.1",
    "call_args":{
        "q":"牛肉",
        "start_price":"0",
        "end_price":"0",
        "page":"10",
        "cat":"0"
    },
    "api_type":"pinduoduo",
    "server_memory":"3.15MB",
    "last_id":false
}

 异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}

错误码解释

状态代码(error_code)状态信息详细描述是否收费
0000success接口调用成功并返回相关数据
2000Search success but no result接口访问成功,但是搜索没有结果
4000Server internal error服务器内部错误
4001Network error网络错误
4002Target server error目标服务器错误
4003Param error用户输入参数错误忽略
4004Account not found用户帐号不存在忽略
4005Invalid authentication credentials授权失败忽略
4006API stopped您的当前API已停用忽略
4007Account stopped您的账户已停用忽略
4008API rate limit exceeded并发已达上限忽略
4009API maintenanceAPI维护中忽略
4010API not found with these valuesAPI不存在忽略
4012Please add api first请先添加api忽略
4013Number of calls exceeded调用次数超限忽略
4014Missing url param参数缺失忽略
4015Wrong pageToken参数pageToken有误忽略
4016Insufficient balance余额不足忽略
4017timeout error请求超时
5000unknown error未知错误
  • 7
    点赞
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值