一、接口参数说明:
二、建议使用场景
1、商品销售情况分析,根据销量调整活动方案,关联销售,库存准备等等
2、获取商品详情页数据信息
3、商城系统建设
4、代购系统商城建设
5、商品控价
三、公共参数说明:
名称 类型 必须 描述
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请求参数说明:
请求参数:q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=
参数说明:q:关键词, sort:排序[bid,_bid,_sale,sale] (bid:商品价格,sale:销量,加_前缀为从大到小排序)
五、响应参数:
称 类型 示例值 描述
items items[] 根据关键词取商品列表
title String 啄木鸟双面穿棉衣女2020冬装加厚宽松韩版棉袄小个子羽绒棉外套冬 商品标题
pic_url String https://t00img.yangkeduo.com/goods/images/2020-12-08/1226cd586487b63527d86fdabb8608cc.jpeg 宝贝图片
price Float 198 价格
promotion_price Float 198 优惠价格
sales Int 14830 销量
num_iid Bigint 203344831134 宝贝ID
sample_id String 商品风格标识ID
seller_nick String 时沫女装专营店 掌柜昵称
post_fee Float 物流费用
area String 店铺所在地
detail_url String http://yangkeduo.com/goods.html?goods_id=203344831134 宝贝链接
六、请求示例:(CURL、PHP 、PHPsdk 、Java 、C# 、Python)
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://点击注册获取/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://点击注册获取/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>
七、返回json数值:
items
keyword "女装"
page "1"
real_total_results 1000
total_results 1000
list_count 20
item
0
title "鲨鱼裤女外穿九分加绒打底裤春秋薄款高腰提臀收腹瑜伽芭比裤子女"
pic_url "https://img.pddpic.com/gaudit-image/2022-09-30/c97d93fdcf3a8574c8a168a6576a59c3.jpeg"
price 9.4
promotion_price 9.4
sales 25000
num_iid 417955634418
sample_id ""
seller_nick "诺媛朵女装官方旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=417955634418"
1
title "反季羽绒棉马甲女加绒加厚2022新款轻薄修身短款保暖内胆大码背心"
pic_url "https://img.pddpic.com/gaudit-image/2022-08-19/ea099b0e01f77536357146e57d5be87c.jpeg"
price 35
promotion_price 35
sales 100000
num_iid 25827130512
sample_id ""
seller_nick "巴乐女装专营店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=25827130512"
2
title "2022秋冬新款半高领打底衫韩版修身上衣长袖t恤女ins牛油果绿体恤"
pic_url "https://t00img.yangkeduo.com/goods/images/2019-08-28/6679d56b38abb3767593b0337e3e9ae7.jpeg"
price 29
promotion_price 29
sales 34000
num_iid 39446637948
sample_id ""
seller_nick "荷塘听雨服装旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=39446637948"
3
title "欧昵雪爱心条纹毛衣女高中生2022新款oversize慵懒风针织套头秋冬"
pic_url "https://img.pddpic.com/gaudit-image/2022-08-06/f6a677406c0eea8fff9e365062233fd5.jpeg"
price 19.18
promotion_price 19.18
sales 25000
num_iid 398730441759
sample_id ""
seller_nick "欧昵雪花执念专卖店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=398730441759"
4
title "小个子微喇裤女2022年秋冬新款九分弹力西装裤高腰显瘦修身喇叭裤"
pic_url "https://img.pddpic.com/gaudit-image/2022-03-01/317ab4a08c339cf60fdd6f4aaabc6619.jpeg"
price 39.9
promotion_price 39.9
sales 23000
num_iid 332311115108
sample_id ""
seller_nick "时裳伊人服饰"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=332311115108"
5
title "高街潮流宽松坠感拖地阔腿裤垂感哈伦裤休闲嘻哈潮牌灯笼裤男女"
pic_url "https://t00img.yangkeduo.com/goods/images/2021-07-09/632f7396a69f63e089b1667276d5e8e2.jpeg"
price 13.9
promotion_price 13.9
sales 98000
num_iid 260099335747
sample_id ""
seller_nick "小衣家服饰"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=260099335747"
6
title "aimilian纯色长袖套头宽松慵懒风基础款圆领白色打底衫内搭T恤女"
pic_url "https://img.pddpic.com/gaudit-image/2022-09-13/cdc000d718da8021abd7bcb7f9982b43.jpeg"
price 14.9
promotion_price 14.9
sales 100000
num_iid 412400072672
sample_id ""
seller_nick "aimilian精选女装旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=412400072672"
7
title "专柜撤柜商场同款宽松白鸭绒修身反季保暖羽绒服外套【11月29日发完】"
pic_url "https://img.pddpic.com/gaudit-image/2021-09-12/3cff50a8a21cc75a150d1988c0234270.jpeg"
price 39
promotion_price 39
sales 100000
num_iid 278069785227
sample_id ""
seller_nick "凌濑穗羽绒服源头基地"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=278069785227"
8
title "牛油果润肤裤打底裤女外穿加绒加厚保暖黑色裤子女秋冬显瘦小脚裤"
pic_url "https://t00img.yangkeduo.com/goods/images/2020-05-31/c6a2a09f8475b2bf2b4df51a37c2e4e5.jpeg"
price 28.69
promotion_price 28.69
sales 100000
num_iid 56657222662
sample_id ""
seller_nick "品染旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=56657222662"
9
title "aimilian加绒加厚阔腿裤子女新款垂感宽松百搭显瘦直筒拖地ins潮"
pic_url "https://img.pddpic.com/gaudit-image/2022-09-19/530c3ca483fc842630485f9f7267f7c3.jpeg"
price 32.37
promotion_price 32.37
sales 14000
num_iid 415441894856
sample_id ""
seller_nick "aimilian女裤官方旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=415441894856"
10
title "鮀品灰色裤子女学生韩版宽松百搭潮流休闲裤2022新款显瘦运动卫裤"
pic_url "https://img.pddpic.com/gaudit-image/2022-04-19/67b0d3dd8cac2f79ab0c5ff84f2dfa14.jpeg"
price 29.9
promotion_price 29.9
sales 100000
num_iid 235468617886
sample_id ""
seller_nick "TUOPIN官方旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=235468617886"
11
title "美式灰色运动裤女宽松束脚秋冬2022年新款直筒阔腿加绒休闲卫裤子"
pic_url "https://img.pddpic.com/gaudit-image/2022-02-15/da6136c72bc3b3ce105d45e4d656acd0.jpeg"
price 45
promotion_price 45
sales 13000
num_iid 327151266724
sample_id ""
seller_nick "飞米特女装官方旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=327151266724"
12
title "秋冬新款2022韩版坠感抽绳阔腿裤高腰宽松显瘦休闲裤百搭直筒裤女"
pic_url "https://img.pddpic.com/gaudit-image/2022-09-11/3621339610b5f748e0aba8262d29c84c.jpeg"
price 10.9
promotion_price 10.9
sales 14000
num_iid 411807335345
sample_id ""
seller_nick "美美闺蜜服饰"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=411807335345"
13
title "RAMPAGE 拉链开衫外套女秋款外穿休闲连帽卫衣oversize宽松上衣潮"
pic_url "https://img.pddpic.com/gaudit-image/2022-08-30/088924fb6e5dfcbfad8ff301099bdd01.jpeg"
price 29.8
promotion_price 29.8
sales 100000
num_iid 408258735904
sample_id ""
seller_nick "RAMPAGE时尚女装官方旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=408258735904"
14
title "高腰牛仔裤女2022新款秋冬显瘦修身弹力百搭加绒女士铅笔小脚裤潮"
pic_url "https://img.pddpic.com/gaudit-image/2022-08-21/0e575a5ff1201effc0de60a12cc2282c.jpeg"
price 20.49
promotion_price 20.49
sales 100000
num_iid 404338267622
sample_id ""
seller_nick "哚儿欣女装旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=404338267622"
15
title "时尚妈妈牛仔裤女春夏季款哈伦萝卜裤高腰显瘦中年休闲女装九分裤"
pic_url "https://t00img.yangkeduo.com/goods/images/2021-04-21/e67e7416bfe00ad5aaf7aeac207d72a4.jpeg"
price 21.8
promotion_price 21.8
sales 100000
num_iid 236023135002
sample_id ""
seller_nick "时尚依坊服饰"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=236023135002"
16
title "黑灰色加绒高腰阔腿牛仔裤女秋季新款调节显瘦宽松直筒垂感拖地裤"
pic_url "https://img.pddpic.com/gaudit-image/2022-10-14/172a6585e7100e3b4611a972ccd61996.jpeg"
price 46.9
promotion_price 46.9
sales 44000
num_iid 406813799439
sample_id ""
seller_nick "尤伊乐服饰"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=406813799439"
17
title "中老年秋冬保暖驼绒棉马甲女护肩妈妈装半袖外穿背心加绒坎肩护肩"
pic_url "https://img.pddpic.com/gaudit-image/2021-08-16/2be7cdbcff76e510cad8b3dc11d3385d.jpeg"
price 24
promotion_price 24
sales 19000
num_iid 270212699538
sample_id ""
seller_nick "弗丽姿女装旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=270212699538"
18
title "单件/两件装中老年九分袖加绒护肩防寒保暖护肩膀马甲大码背心女"
pic_url "https://img.pddpic.com/gaudit-image/2021-12-01/20fa453917ff8f975240a6014073b02d.jpeg"
price 10.99
promotion_price 10.99
sales 2887
num_iid 307507584604
sample_id ""
seller_nick "媛媛家美衣二"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=307507584604"
19
title "雅慕雪大码宽松休闲外套女夹克衫韩版百搭妈妈洋气上衣夹克风衣女"
pic_url "https://t00img.yangkeduo.com/goods/images/2021-04-29/cc6d5b96cbe7d580be6538b75fb4f6a7.jpeg"
price 28.48
promotion_price 28.48
sales 12000
num_iid 239888141134
sample_id ""
seller_nick "雅慕雪服饰旗舰店"
post_fee ""
area ""
detail_url "http://yangkeduo.com/goods.html?goods_id=239888141134"
error_code "0000"
reason "ok"
secache "a8881ed5637e3c7e84f03acdc86be64f"
secache_time 1667270017
secache_date "2022-11-01 10:33:37"
translate_status ""
translate_time 0
language
default_lang "cn"
current_lang "cn"
error ""
cache 0
api_info "today:49 max:10100 all[115=49+48+18];expires:2030-12-31"
execution_time "1.165"
server_time "Beijing/2022-11-01 10:33:37"
client_ip "106.6.34.202"
call_args
q "女装"
start_price "0"
end_price "0"
page "1"
cat "0"
api_type "pinduoduo"
translate_language "zh-CN"
translate_engine "baidu"
server_memory "3.19MB"
request_id "gw-1.63608580c9520"
last_id "1326184126"
八、异常示例
{
"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"}
九、错误代码解释
API 工具
API SDK调用示例APISDK下载API测试工具
如何开通API测试,点击测试