引言
在激烈的电商市场中,数据的获取与分析对于商家至关重要。拼多多作为中国快速崛起的电商平台,为商家提供了丰富的API接口,以便更高效地管理和获取商品数据。本文将详细介绍拼多多的“根据ID取商品详情API接口”和“根据关键词取商品列表API”,探讨它们如何帮助商家优化运营策略。
item_get-根据ID取商品详情
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版本 |
请求参数
请求参数: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 | 未知错误 | 否 |
拼多多商品详情API接口
拼多多的商品详情API允许商家通过商品的唯一标识符(ID)获取商品的详细信息,包括商品名称、价格、库存、详情描述、图片等。
应用场景
- 商品信息展示:在自有平台或移动应用中展示拼多多商品的详细信息。
- 库存管理:实时同步商品库存,优化供应链管理。
- 数据分析:分析商品的销量、评价等数据,以制定营销策略。
集成步骤
- 获取API权限:在拼多多开放平台上注册开发者账号并创建应用,获取API调用权限。
- 发送请求:使用HTTP请求发送到API服务器,传递必要的参数,如商品ID。
- 解析响应:处理API返回的JSON或XML格式数据,提取商品信息。
根据关键词取商品列表API
拼多多的关键词搜索API允许商家根据特定的关键词搜索平台上的商品,并返回相关的商品列表。
应用场景
- 商品推荐系统:根据用户的搜索习惯和偏好,推荐相关商品。
- 价格比较工具:聚合不同店铺的商品价格,提供比较服务。
- 市场趋势分析:通过关键词搜索分析,洞察市场趋势和消费者需求。
集成步骤
- 关键词设定:确定搜索的关键词,如商品名称、品牌、型号等。
- 请求构造:根据API文档构造HTTP请求,包括关键词和其他筛选条件。
- 结果解析:解析API返回的JSON数据,获取商品列表。
数据挖掘与商业智能
结合拼多多商品详情API和关键词搜索API,商家可以实现以下商业智能应用:
- 个性化推荐:根据用户的搜索历史和购买行为,提供个性化的商品推荐。
- 价格监控:监控商品价格变化,实现动态定价策略。
- 市场趋势分析:分析商品销量和用户评价,洞察市场趋势。
结语
拼多多的商品详情API和关键词搜索API为电商领域的商家提供了强大的数据支持。通过合理利用这些API,商家可以更精准地掌握商品信息,优化营销策略,提升用户体验。随着电商平台技术的不断进步,未来的商品搜索和数据分析将更加智能化和个性化,电商行业的服务模式也将因此发生深刻的变革。商家需要不断学习和掌握新技术,以更好地利用拼多多平台的API进行业务创新和发展。