关于拼多多根据关键词取商品列表 API 的使用说明

公共参数

请求地址: https://api-gw.onebound.cn/pinduoduo/item_search

前往获取key和secret

名称	类型	必须	描述
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		根据关键词取商品列表
title	String	0	啄木鸟双面穿棉衣女2020冬装加厚宽松韩版棉袄小个子羽绒棉外套冬	商品标题
pic_url	String	0	https://t00img.yangkeduo.com/goods/images/2020-12-08/1226cd586487b63527d86fdabb8608cc.jpeg	宝贝图片
price	Float	0	198	价格
promotion_price	Float	0	198	优惠价格
sales	Int	0	14830	销量
num_iid	Bigint	0	203344831134	宝贝ID
sample_id	String	0		商品风格标识ID
seller_nick	String	0	时沫女装专营店	掌柜昵称
post_fee	Float	0		物流费用
area	String	0		店铺所在地
detail_url	String	0	http://yangkeduo.com/goods.html?goods_id=203344831134	宝贝链接

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/pinduoduo/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size="

响应示例

{
	  "items": {
		"keyword": "女装",
		"page": "1",
		"real_total_results": 300,
		"total_results": 300,
		"list_count": 20,
		"item": [
			{
				"title": "【三件套】新款秋冬季女装套装裙皮草短外套搭打底衫毛衣配半身裙",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-06-05/b15035efb5913e1e8b647422010522c1.jpeg",
				"price": 134,
				"promotion_price": 134,
				"sales": 18000,
				"num_iid": 43992967514,
				"sample_id": "",
				"seller_nick": "果果家气质女装",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=43992967514"
			},
			{
				"title": "【2件套】套装秋冬新款仿獭兔毛钉珠皮草毛毛短外套加厚大衣女装",
				"pic_url": "https://omsproductionimg.yangkeduo.com/images/2018-06-06/463c0e2a5580ba3266846e41fe3e444a.jpeg",
				"price": 169,
				"promotion_price": 169,
				"sales": 40000,
				"num_iid": 1620002566,
				"sample_id": "",
				"seller_nick": "果果家气质女装",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=1620002566"
			},
			{
				"title": "仿水貂毛皮草外套女冬短款韩版修身显瘦百搭毛绒加厚新娘披肩礼服",
				"pic_url": "https://omsproductionimg.yangkeduo.com/images/2018-01-03/1f3866498a067e00e39a38fe144ec5f3.jpeg",
				"price": 88,
				"promotion_price": 88,
				"sales": 218,
				"num_iid": 410684172,
				"sample_id": "",
				"seller_nick": "乐荣源淘衣坊",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=410684172"
			},
			{
				"title": "仿貂毛大衣女秋冬加厚仿狐狸毛领皮草外套女长款仿水貂绒外套显瘦",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-06-28/f6ea981d0cfe5dc096af33457328c819.jpeg",
				"price": 298,
				"promotion_price": 298,
				"sales": 42000,
				"num_iid": 144592781204,
				"sample_id": "",
				"seller_nick": "珞摩服装旗舰店",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=144592781204"
			},
			{
				"title": "三件套裙套装新款秋冬女韩版钉珠皮草短外套搭打底衫毛衣配半身裙",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-24/1fd6806d8de95adce0196294765079f1.jpeg",
				"price": 269,
				"promotion_price": 269,
				"sales": 2525,
				"num_iid": 2748395485,
				"sample_id": "",
				"seller_nick": "蹦蹦服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=2748395485"
			},
			{
				"title": "三件套2020新款秋冬季皮草裙套装女短外套搭打底衫毛衣配半身裙子",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-10-22/97440d8034ad1a319e71cd501aa6d9bc.jpeg",
				"price": 239,
				"promotion_price": 239,
				"sales": 119,
				"num_iid": 4544773413,
				"sample_id": "",
				"seller_nick": "自然之美服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=4544773413"
			},
			{
				"title": "三件套裙套装2020新款秋冬季皮草女短外套搭打底衫毛衣配半身裙子",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-10-23/0e5aa1adb63ce256664d4274d0ff0fa1.jpeg",
				"price": 188,
				"promotion_price": 188,
				"sales": 1587,
				"num_iid": 3540607180,
				"sample_id": "",
				"seller_nick": "自然之美服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=3540607180"
			},
			{
				"title": "2020秋冬装毛毛钉珠仿皮草外套新款韩版修身圆领学生上衣【单件】",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2021-01-28/503c10fe716873ceaccf103c30881908.jpeg",
				"price": 79,
				"promotion_price": 79,
				"sales": 1157,
				"num_iid": 35225305026,
				"sample_id": "",
				"seller_nick": "夏衣伊人",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=35225305026"
			},
			{
				"title": "两件套秋冬新款气质钉珠仿皮草外套配刺绣半身裙保暖加厚上衣女装",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-17/5d57e2f0df37b13f5472d03175246d28.jpeg",
				"price": 139,
				"promotion_price": 139,
				"sales": 2616,
				"num_iid": 369492636,
				"sample_id": "",
				"seller_nick": "蹦蹦服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=369492636"
			},
			{
				"title": "2020秋冬装毛毛钉珠仿皮草外套新款韩版修身圆领淑女上衣【单件】",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2021-01-28/b208cc827f66c0b5eac9d40762178d28.jpeg",
				"price": 88,
				"promotion_price": 88,
				"sales": 232,
				"num_iid": 3540686169,
				"sample_id": "",
				"seller_nick": "自然之美服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=3540686169"
			},
			{
				"title": "2018秋冬装毛毛钉珠仿皮草外套新款韩版修身圆领学生上衣【单件】",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2018-09-24/22c7a21f49c4ddfe228acc5d15c1bbe0.jpeg",
				"price": 138,
				"promotion_price": 138,
				"sales": 210,
				"num_iid": 3062555797,
				"sample_id": "",
				"seller_nick": "果果家气质女装",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=3062555797"
			},
			{
				"title": "三件套网红裙套装新款秋冬女钉珠皮草搭打底衫毛衣配半身裙短外套",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/images/2019-09-10/403fae6f0c281b247e305559cff71cca.jpeg",
				"price": 269,
				"promotion_price": 269,
				"sales": 144,
				"num_iid": 35224334938,
				"sample_id": "",
				"seller_nick": "夏衣伊人",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=35224334938"
			},
			{
				"title": "单件外套短款女秋冬新品海宁仿皮草韩版宽松显瘦百搭钉珠圆领上衣",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-24/55a25e3b612a5ba2655046718a20c0ab.jpeg",
				"price": 88,
				"promotion_price": 88,
				"sales": 2314,
				"num_iid": 368488818,
				"sample_id": "",
				"seller_nick": "蹦蹦服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=368488818"
			},
			{
				"title": "粗花呢套装女2020秋冬新款小香风时尚洋气小西装包臀裙休身显瘦潮",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-07-16/84ffe1375b1d3b1a6455b9c387cd495b.jpeg",
				"price": 139,
				"promotion_price": 139,
				"sales": 216,
				"num_iid": 150435444702,
				"sample_id": "",
				"seller_nick": "小清新职装",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=150435444702"
			},
			{
				"title": "啄木鸟加厚羽绒棉衣女冬季新款胖mm宽松显瘦棉服外套女士大码棉袄",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-11-24/a8798a380a8e64503a3b6f2df3cdc5e6.jpeg",
				"price": 148,
				"promotion_price": 148,
				"sales": 2866,
				"num_iid": 203004819547,
				"sample_id": "",
				"seller_nick": "啄木鸟清晚田专卖店",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=203004819547"
			},
			{
				"title": "小香风套装裙女秋冬两件套裙子时尚气质贵夫人高档显瘦小西服上衣",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-09-20/11b73b78660ce240318981f36fedb20b.jpeg",
				"price": 106.8,
				"promotion_price": 106.8,
				"sales": 3585,
				"num_iid": 179099550022,
				"sample_id": "",
				"seller_nick": "蝶之语服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=179099550022"
			},
			{
				"title": "粉色小西装春季新款名媛小香风套装裙两件套韩版时尚百搭收腰显瘦",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-03-17/2c08521a36bae37e004a5cfe15fcddb1.jpeg",
				"price": 119,
				"promotion_price": 119,
				"sales": 136,
				"num_iid": 94383041769,
				"sample_id": "",
				"seller_nick": "小清新职装",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=94383041769"
			},
			{
				"title": "小清新刺绣两件套套装裙兔毛领拼接短外套毛呢连衣裙秋冬甜美新款",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2019-10-07/6f734d1717a3339a74cff707d9ec82c0.jpeg",
				"price": 688,
				"promotion_price": 688,
				"sales": 3602,
				"num_iid": 50964999845,
				"sample_id": "",
				"seller_nick": "木木时尚服饰",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=50964999845"
			},
			{
				"title": "毛呢两件套装裙子女2021春秋季新款中长连衣裙修身妈妈装短款外套",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-03-12/d9b47beb0f7306f132216c910640f830.jpeg",
				"price": 89.8,
				"promotion_price": 89.8,
				"sales": 32000,
				"num_iid": 2713732007,
				"sample_id": "",
				"seller_nick": "露雪颜旗舰店",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=2713732007"
			},
			{
				"title": "白鸭绒2020冬季新款网红苏苏羽绒服女中长款大毛领收腰加厚外套潮",
				"pic_url": "https://t00img.yangkeduo.com/goods/images/2020-12-13/735fb9bd599594a424f3f22957aafd06.jpeg",
				"price": 299,
				"promotion_price": 299,
				"sales": 3292,
				"num_iid": 45642569064,
				"sample_id": "",
				"seller_nick": "晗晗羽绒厂家店",
				"post_fee": "",
				"area": "",
				"detail_url": "http://yangkeduo.com/goods.html?goods_id=45642569064"
			}
		]
	},
	"error_code": "0000",
	"reason": "ok",
	"secache": "a8881ed5637e3c7e84f03acdc86be64f",
	"secache_time": 1615362351,
	"secache_date": "2021-03-10 15:45:51",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"cache": 0,
	"api_info": "today:30 max:10000",
	"execution_time": 0.649,
	"server_time": "Beijing/2021-03-10 15:45:51",
	"client_ip": "106.6.35.144",
	"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": "2.92MB",
	"request_id": "gw-1.6048792eb5a86"
}