拼多多根据ID取商品详情 API接口（拼多多开放平台合作）

拼多多提供了获取商品详情的API接口，具体如下：

公共参数

请求地址：​​前往测试​​ 

公共参数

名称	类型	必须	描述
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版本

此API目前支持以下基本接口：

• item_get 根据ID取商品详情
• item_search 根据关键词取商品列表
• item_search_data 获得搜索词统计
• item_search_suggest 获得搜索词推荐

 

请求参数

请求参数：num_iid=1620002566

参数说明：num_iid:商品ID ;

响应参数

Version: Date:

名称	类型	必须	示例值	描述
num_iid	String	0	1999629976	商品ID
title	String	0	2019新款女装短袖t恤女夏宽松韩版休闲上衣百搭蝙蝠衫五分袖体恤	商品标题
price	Float	0	8.8	价格
minGroupPrice	String	0
maxGroupPrice	String	0
total_price	Float	0
orginal_price	Float	0		原价
nick	String	0	雅怡服饰1688	卖家昵称
num	Int	0	233	库存
sales	Int	0	76	销量
detail_url	String	0	http://yangkeduo.com/goods.html?goods_id=1999629976	宝贝链接
desc	String	0	本店默认申通快递【还有百世汇通 中通快递 中通 韵达 邮政】。商家建议尺码仅供参考。如有其它问题请及时联系客服!喜欢的赶紧购买,质量保证,买的放心,穿的也开心!	商品备注
item_imgs	Mix	0	[{"url": "//t00img.yangkeduo.com/t05img/images/2018-06-28/24bcb29df1195edaea840afd3e1bdaf9.jpeg?imageMogr2/strip%7CimageView2/2/w/1300/q/80"}]	宝贝图片列表
pic_url	String	0	//t00img.yangkeduo.com/t05img/images/2018-06-28/24bcb29df1195edaea840afd3e1bdaf9.jpeg?imageMogr2/thumbnail/150x/quality/50	宝贝图片
props_name	String	0		商品属性名
prop_imgs	Mix	0	{"prop_img": [ {"properties": "0:0;1:1", "url": "//t00img.yangkeduo.com/t10img/images/2018-06-28/5c8f783ab2c4fea0ffea8fac73d8b2c2.jpeg"}]}	商品属性图片列表
props	Mix	0		商品详情
skus	Mix	0	{"sku": [{"price": "16.56", "total_price": null, "orginal_price": "20.9", "properties": "0:0;1:1", "properties_name": "0:0:颜色:黑色;1:1:尺码:M【75-100斤】", "quantity": 221, "sku_id": 36410965966}]	商品规格信息
props_list	Mix	0	{ "0:0": "颜色:黑色","1:1": "尺码:M【75-100斤】"}	商品属性
props_img	Mix	0	{"0:0;1:1": "//t00img.yangkeduo.com/t10img/images/2018-06-28/5c8f783ab2c4fea0ffea8fac73d8b2c2.jpeg"}	属性图片
property_alias	String	0		商品属性别名
seller_info	Mix	0	{"nick": "雅怡服饰1688", "city": "", "level": null, "rate": null, "score": 4.27, "delivery_score": 4.37, "item_score": 4.38, "shop_type": "", "user_num_id": "", "sid": 99033, "shop_name": "雅怡服饰1688", "zhuy": "", "menu": [] }	卖家信息
shop_item	Mix	0	[]
relate_items	Mix	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	未知错误	否