拼多多官方开放平台接口app商品详情接口获取实时商品详情数据演示
拼多多开放平台提供了一种名为“商品详情接口”的API接口，它允许卖家从自己的系统中快速获取商品信息，如商品标题、描述、价格、库存等，并将这些信息展示在自己的店铺中。通过该接口，卖家可以更好地管理自己的商品库存和销售，提高效率。
pinduoduo.item_get_app_pro-根据ID取商品详情原数据
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中）注册调用key请求接入API |
| 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版本 |
请求参数
请求参数：num_iid=1620002566
参数说明：num_iid:商品ID ;
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item |
Mix | 0 | 获得拼多多app商品详情原数据 | |
| goods |
Mix | 0 | [] | 商品信息 |
| sku |
Mix | 0 | [] | sku价格信息 |
| price |
Mix | 0 | [] | 价格信息 |
| view_img |
Mix | 0 | [] | 商品主图 |
| detail_gallery |
Mix | 0 | [] | 商品描述 |
| more |
Mix | 0 | [] | 参数多不一一介绍，详细请看接口返回 |
响应示例
{
"item": {
"server_time": 1699501362,
"destination_url": "order_checkout.html",
"destination_type": 2,
"pre_render_url": "csr/comm_mall_home_pre_render.html",
"goods": {
"goods_id": 448181168436,
"cat_id": 16358,
"mall_id": 227248943,
"brand_id": 1060372,
"quantity": 938,
"country": "",
"warehouse": "",
"goods_type": 1,
"vas_template_id": [],
"goods_name": "狗狗零食磨牙棒鸡肉甜甜圈洁齿宠物零食牛皮狗咬胶大小型犬通用",
"goods_name_suffix": "",
"share_desc": "狗狗零食磨牙棒鸡肉甜甜圈洁齿宠物零食牛皮狗咬胶大小型犬通用",
"share_title": "狗狗零食磨牙棒鸡肉甜甜圈洁齿宠物零食牛皮狗咬胶大小型犬通用",
"share_link": "goods1.html?goods_id=448181168436&page_from=0&pxq_secret_key=6WPSKBOT2D5ZJLCBJUURUYJD3OUV5XCEB5542FV4SSCLQD2262PQ",
"preview_share_link": "mall_quality_assurance.html?_t_timestamp=comm_share_landing&goods_id=448181168436",
"side_sales_tip": "",
"sold_quantity": 0,
"is_onsale": 1,
"is_sku_onsale": 1,
"is_pre_sale": 0,
"pre_sale_time": "",
"is_subsidy": 0,
"thumb_url": "https://img.pddpic.com/gaudit-image/2023-02-15/27b26b80b7cf35497cc7af3c7daa6dee.jpeg",
"hd_thumb_url": "https://img.pddpic.com/gaudit-image/2023-02-15/8cb31e14a075ce1043d118ed38390c05.jpeg",
"image_url": "https://img.pddpic.com/gaudit-image/2023-02-15/27b26b80b7cf35497cc7af3c7daa6dee.jpeg",
"second_hand": 0,
"main_gallery": [
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-15/c860618f-9674-4d57-ba2d-4c7abc7384c3.jpeg",
"id": 972223559833,
"priority": 0
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-15/5357333e-bf2e-456d-9bdf-2e39c39027b5.jpeg",
"id": 972223559834,
"priority": 1
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-15/17c7e5b9-e650-4ce8-8099-3e32c8b8e585.jpeg",
"id": 972223559835,
"priority": 2
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-15/d1530c38-0935-4e31-ba9f-6c4ec65c7b4b.jpeg",
"id": 972223559836,
"priority": 3
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-15/39add2b3-0ed6-42e4-9f0b-0159c3ec572a.jpeg",
"id": 972223559837,
"priority": 4
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-15/faeb1c68-377a-4317-9d30-2a7cffb6e34a.jpeg",
"id": 972223559838,
"priority": 5
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/f3328cf2-b2e3-4ae4-92a6-59a19b423357.jpeg",
"id": 972223559839,
"priority": 6
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-16/11c6a1b9-693d-46d5-bd6c-9d872da78761.jpeg",
"id": 972223559840,
"priority": 7
}
],
"decoration": [
{
"floor_id": 22565991427,
"key": "DecImage",
"type": "image",
"priority": 0,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/82dbd096-5221-45ab-aa61-fd6f4b0db524.jpeg",
"height": 790,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991428,
"key": "DecImage",
"type": "image",
"priority": 1,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/d04ba2f1-282f-42bf-83f1-2d09be69c6fd.jpeg",
"height": 729,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991429,
"key": "DecImage",
"type": "image",
"priority": 2,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/17ca3289-ce56-43e8-b523-952234dc7e15.jpeg",
"height": 849,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991430,
"key": "DecImage",
"type": "image",
"priority": 3,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/7ed471bf-6661-4375-8c1d-50357a27d472.jpeg",
"height": 953,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991431,
"key": "DecImage",
"type": "image",
"priority": 4,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/6062af74-4ae7-4165-8846-067cd706f277.jpeg",
"height": 799,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991432,
"key": "DecImage",
"type": "image",
"priority": 5,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/7d2b227b-9e54-4f2a-a293-bc28c08f2b18.jpeg",
"height": 763,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991433,
"key": "DecImage",
"type": "image",
"priority": 6,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/f2bb1a15-ef6b-407e-8895-97d3d87ee5e6.jpeg",
"height": 780,
"width": 790
}
],
"enable_share": 1
},
{
"floor_id": 22565991434,
"key": "DecImage",
"type": "image",
"priority": 7,
"contents": [
{
"img_url": "https://img.pddpic.com/mms-material-img/2023-02-10/cdc45b6d-781b-4849-9a12-89152fb75160.jpeg",
"height": 312,
"width": 790
}
],
"enable_share": 1
}
],
"view_img": [
"https://img.pddpic.com/mms-material-img/2023-02-15/c860618f-9674-4d57-ba2d-4c7abc7384c3.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-15/5357333e-bf2e-456d-9bdf-2e39c39027b5.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-15/17c7e5b9-e650-4ce8-8099-3e32c8b8e585.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-15/d1530c38-0935-4e31-ba9f-6c4ec65c7b4b.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-15/39add2b3-0ed6-42e4-9f0b-0159c3ec572a.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-15/faeb1c68-377a-4317-9d30-2a7cffb6e34a.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-10/f3328cf2-b2e3-4ae4-92a6-59a19b423357.jpeg",
"https://img.pddpic.com/mms-material-img/2023-02-16/11c6a1b9-693d-46d5-bd6c-9d872da78761.jpeg"
],
"detail_gallery": [
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/82dbd096-5221-45ab-aa61-fd6f4b0db524.jpeg",
"width": 790,
"height": 790,
"priority": 8
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/d04ba2f1-282f-42bf-83f1-2d09be69c6fd.jpeg",
"width": 790,
"height": 729,
"priority": 9
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/17ca3289-ce56-43e8-b523-952234dc7e15.jpeg",
"width": 790,
"height": 849,
"priority": 10
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/7ed471bf-6661-4375-8c1d-50357a27d472.jpeg",
"width": 790,
"height": 953,
"priority": 11
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/6062af74-4ae7-4165-8846-067cd706f277.jpeg",
"width": 790,
"height": 799,
"priority": 12
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/7d2b227b-9e54-4f2a-a293-bc28c08f2b18.jpeg",
"width": 790,
"height": 763,
"priority": 13
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/f2bb1a15-ef6b-407e-8895-97d3d87ee5e6.jpeg",
"width": 790,
"height": 780,
"priority": 14
},
{
"url": "https://img.pddpic.com/mms-material-img/2023-02-10/cdc45b6d-781b-4849-9a12-89152fb75160.jpeg",
"width": 790,
"height": 312,
"priority": 15
}
],
"video_gallery": [],
"detail_video_gallery": [],
"group": [
{
"requireNum": "1",
"price": "0",
"groupID": 87620410766,
"startTime": 1451577600,
"endTime": 2082729600,
"orderLimit": 999999
},
{
"requireNum": "2",
"price": "0",
"groupID": 87620410767,
"startTime": 1451577600,
"endTime": 2082729600,
"orderLimit": 999999
}
],
"goods_property_type": 0,
"property_card_click": 0,
"goods_property": [
{
"key": "品牌",
"values": [
"馋乐滋"
],
"ref_pid": 310,
"reference_id": 1060372
},
{
"key": "发货地",
"values": [
"山东省"
]
},
{
"key": "净含量",
"values": [
"100g"
],
"ref_pid": 714,
"reference_id": 0
},
{
"key": "包装方式",
"values": [
"袋装"
],
"ref_pid": 677,
"reference_id": 0
},
{
"key": "剩余保质期",
"values": [
"6个月及以上"
],
"ref_pid": 2021,
"reference_id": 0
},
{
"key": "生产日期",
"values": [
"2023-10-11"
],
"ref_pid": 405,
"reference_id": 0
},
{
"key": "保质期",
"values": [
"540天"
],
"ref_pid": 406,
"reference_id": 0
}
],
"property_show_num": 6,
"prompt_explain": "",
"check_quantity": 1,
"cat_id_1": 16288,
"cat_id_2": 16357,
"cat_id_3": 16358,
"cat_id_4": 0,
"status": 1
},
"sku": [
{
"sku_id": 1379756722415,
"is_onsale": 1,
"is_sku_pre_sale": 0,
"sku_pre_sale_time": "",
"sku_pre_sale_tip": "",
"normal_price": "40.0",
"normal_save_price": "12.5",
"group_price": "27.5",
"quantity": 100,
"weight": 0,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-04-23/d42dbfa8-a214-4333-b224-272845a87c8e.jpeg",
"spec": "18311952301",
"spec_keys": "套餐",
"spec_values": "4个 【 超大15cm】鸡肉牛皮圈",
"price_display": [],
"group_tip": ""
},
{
"sku_id": 1379765932993,
"is_onsale": 1,
"is_sku_pre_sale": 0,
"sku_pre_sale_time": "",
"sku_pre_sale_tip": "",
"normal_price": "30.0",
"normal_save_price": "13.5",
"group_price": "16.5",
"quantity": 100,
"weight": 0,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-04-23/d42dbfa8-a214-4333-b224-272845a87c8e.jpeg",
"spec": "18312274713",
"spec_keys": "套餐",
"spec_values": "2个【 超大15cm】鸡肉甜甜圈",
"price_display": [],
"group_tip": ""
},
{
"sku_id": 1379765932994,
"is_onsale": 1,
"is_sku_pre_sale": 0,
"sku_pre_sale_time": "",
"sku_pre_sale_tip": "",
"normal_price": "17.0",
"normal_save_price": "7.2",
"group_price": "9.8",
"quantity": 100,
"weight": 0,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-04-23/d42dbfa8-a214-4333-b224-272845a87c8e.jpeg",
"spec": "18312274667",
"spec_keys": "套餐",
"spec_values": "1个【 超大15cm】鸡肉甜甜圈",
"price_display": [],
"group_tip": ""
},
{
"sku_id": 1379756722419,
"is_onsale": 1,
"is_sku_pre_sale": 0,
"sku_pre_sale_time": "",
"sku_pre_sale_tip": "",
"normal_price": "40.0",
"normal_save_price": "12.5",
"group_price": "27.5",
"quantity": 100,
"weight": 0,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-04-25/7ecc5a20-79d8-401c-a25b-4e2e134d5c46.jpeg",
"spec": "18311944951",
"spec_keys": "套餐",
"spec_values": "8个【 中号10cm】鸡肉牛皮圈",
"price_display": [],
"group_tip": ""
},
{
"sku_id": 1379756722420,
"is_onsale": 1,
"is_sku_pre_sale": 0,
"sku_pre_sale_time": "",
"sku_pre_sale_tip": "",
"normal_price": "30.0",
"normal_save_price": "13.5",
"group_price": "16.5",
"quantity": 100,
"weight": 0,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-04-25/7ecc5a20-79d8-401c-a25b-4e2e134d5c46.jpeg",
"spec": "18311957437",
"spec_keys": "套餐",
"spec_values": "4 【 中号10cm】鸡肉牛皮圈",
"price_display": [],
"group_tip": ""
},
{
"sku_id": 1379756722421,
"is_onsale": 1,
"is_sku_pre_sale": 0,
"sku_pre_sale_time": "",
"sku_pre_sale_tip": "",
"normal_price": "17.0",
"normal_save_price": "7.2",
"group_price": "9.8",
"quantity": 100,
"weight": 0,
"thumb_url": "https://img.pddpic.com/mms-material-img/2023-04-25/7ecc5a20-79d8-401c-a25b-4e2e134d5c46.jpeg",
"spec": "18311949879",
"spec_keys": "套餐",
"spec_values": "2个【 中号10cm】鸡肉牛皮圈",
"price_display": [],
"group_tip": ""
}
],
"specs": [
{
"spec_key_id": 20711,
"spec_key": "套餐",
"spec_values": [
{
"18311952301": "4个 【 超大15cm】鸡肉牛皮圈"
},
{
"18312274713": "2个【 超大15cm】鸡肉甜甜圈"
},
{
"18312274667": "1个【 超大15cm】鸡肉甜甜圈"
},
{
"18311944951": "8个【 中号10cm】鸡肉牛皮圈"
},
{
"18311957437": "4 【 中号10cm】鸡肉牛皮圈"
},
{
"18311949879": "2个【 中号10cm】鸡肉牛皮圈"
}
]
}
],
"price": {
"line_price": 5200,
"price_style": 2,
"browser_price_style": 2,
"min_on_sale_group_price": 980,
"max_on_sale_group_price": 2750,
"min_on_sale_normal_price": 1700,
"max_on_sale_normal_price": 4000,
"min_group_price": 980,
"max_group_price": 2750,
"max_normal_price": 4000,
"min_normal_price": 1700,
"unselect_normal_save_price": 980,
"new_price_prefix": "券前"
},
"service_promise": [
{
"id": 3,
"type": "退货包运费",
"typeColor": "#58595B",
"dialogType": "退货包运费",
"dialogTypeColor": "#151516",
"desc": "订单发货后90天内申请退货退款或换货，拼多多将按照物流首重费用补贴退货运费",
"top": 1,
"topType": 1,
"navigation": 0,
"navigationUrl": "",
"showTip": "收货后如不满意，可以免费退货",
"detailHidden": 0
},
{
"id": 1,
"type": "全场包邮",
"typeColor": "#58595B",
"dialogType": "全场包邮",
"dialogTypeColor": "#151516",
"desc": "所有商品包邮",
"top": 0,
"topType": 0,
"navigation": 0,
"navigationUrl": "",
"detailHidden": 0
},
{
"id": 2,
"type": "7天无理由退货",
"typeColor": "#58595B",
"dialogType": "7天无理由退货",
"dialogTypeColor": "#151516",
"desc": "满足相应条件时，消费者可申请“7天无理由退货”，其中定制订单不支持“7天无理由退货”",
"top": 0,
"topType": 0,
"navigation": 0,
"navigationUrl": "",
"detailHidden": 0
},
{
"id": 15,
"type": "假一赔十",
"typeColor": "#58595B",
"dialogType": "假一赔十",
"dialogTypeColor": "#151516",
"desc": "若收到商品是假冒品牌，可获得十倍现金券赔偿",
"top": 0,
"topType": 0,
"navigation": 0,
"navigationUrl": "",
"detailHidden": 0
},
{
"id": 13,
"type": "48小时发货",
"typeColor": "#58595B",
"dialogType": "48小时发货",
"dialogTypeColor": "#151516",
"desc": "订单支付成功后48小时内发货，若未在48小时内发货，消费者将会收到至少3元无门槛代金券",
"top": 0,
"topType": 0,
"navigation": 0,
"navigationUrl": "",
"detailHidden": 0
}
],
"promotion": {
"events": {
"mall_promotion_new_cell": {
"cell_detail_list": [
{
"copy_writing": "即将恢复14.5元起",
"cell_tag_type": 6,
"copy_writing_color": "#E02E24",
"frame_color": "#E02E24",
"background_color": "#FFFFFF"
},
{
"copy_writing": "2件9.5折",
"cell_tag_type": 26,
"copy_writing_color": "#E02E24",
"frame_color": "#E02E24",
"background_color": "#FFFFFF"
},
{
"copy_writing": "满79减3",
"cell_tag_type": 4,
"copy_writing_color": "#E02E24",
"frame_color": "#E02E24",
"background_color": "#FFFFFF"
}
]
}
},
"promotionEvents": []
},
"ui": [],
"neighbor_group": [],
"review": {
"reviewNum": 8698
},
"mall_entrance": {
"mall_data": {
"mallId": "227248943",
"mallName": "汪星人乐园",
"mallShowType": 0,
"mallTransferType": 0,
"salesTip": "已拼4.6万件",
"salesTipV2": "全店已拼4.6万件",
"mallSales": 46000,
"mallLogo": "http://t16img.yangkeduo.com/pdd_ims/img_check/v2/F3E6FF9A2BE40420200112154811880/a940feeb96594576bdbabe188ebf339f.png",
"goodsNum": 40,
"goodsNumDesc": "商品数量: 40",
"pddRoute": "mall_page.html?mall_id=227248943",
"pddRouteName": "进店逛逛",
"mallServiceTag": "客服",
"isFlagShip": false,
"logoList": [],
"mallLogoList": [
{
"logoType": 4,
"logoUrl": "https://promotion.pddpic.com/oms-img-promotion/2023-10-18/bd299815-d796-43aa-a987-6ea7a3910df3.png",
"logoHeight": 51,
"logoWidth": 120
}
],
"dsr": {
"descScore": 4.7,
"descStatus": 1,
"logisticsScore": 4.7,
"logisticsStatus": 1,
"serviceScore": 4.7,
"serviceStatus": 1,
"descRankPercent": 73,
"logisticsRankPercent": 73,
"serviceRankPercent": 73,
"descRankStatus": 1,
"logisticsRankStatus": 1,
"serviceRankStatus": 1,
"hideRankInfo": 0,
"mallRatingTextList": [
{
"mall_rating_key": {
"txt": "描述相符",
"color": "#58595B",
"font": 13
},
"mall_rating_value": {
"txt": "高",
"color": "#E02E24",
"font": 11,
"back_color": "#FCE5E5"
}
},
{
"mall_rating_key": {
"txt": "物流服务",
"color": "#58595B",
"font": 13
},
"mall_rating_value": {
"txt": "高",
"color": "#E02E24",
"font": 11,
"back_color": "#FCE5E5"
}
},
{
"mall_rating_key": {
"txt": "服务态度",
"color": "#58595B",
"font": 13
},
"mall_rating_value": {
"txt": "高",
"color": "#E02E24",
"font": 11,
"back_color": "#FCE5E5"
}
}
],
"mallStar": 5,
"isShowMallStar": true
},
"isGuideMall": false,
"extras": {
"2": false,
"3": false,
"5": 1,
"7": false,
"8": true
},
"msn": "",
"merchantType": 1,
"hasMallDecoration": false,
"mallHeadTagVo": [],
"hideShipAddress": false,
"mallFavVo": {
"showButton": false
},
"mallID": "227248943",
"logo": "http://t16img.yangkeduo.com/pdd_ims/img_check/v2/F3E6FF9A2BE40420200112154811880/a940feeb96594576bdbabe188ebf339f.png"
}
},
"section_list": [],
"sub_sections": [],
"app_ver": "5.0.1-7.0",
"_ddf": "xbd",
"app_ver_check": "ok",
"format_check": "ok"
},
"error": "",
"secache": "77e7e5eb16ea8ae4c7963d2af5be5c7f",
"secache_time": 1699508099,
"secache_date": "2023-11-09 13:34:59",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:456 max:10000 all[692=456+173+63];expires:2030-12-31",
"execution_time": "0.385",
"server_time": "Beijing/2023-11-09 13:34:59",
"client_ip": "106.6.34.87",
"call_args": {
"num_iid": "448181168436"
},
"api_type": "pinduoduo",
"translate_language": "zh-CN",
"translate_engine": "Hcw",
"server_memory": "4.32MB",
"request_id": "2.654c6f82e4cb3",
"last_id": "2251330899"
}