拼多多API,全称应用程序接口,是一种提供特定功能和服务的软件接口。对于拼多多平台而言,API是其对外开放的一种接口,允许开发者调用拼多多的商品信息、订单信息、物流信息等数据,以便在第三方平台上进行集成、扩展和创新。
pinduoduo.item_search
公共参数
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数: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) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |