有关于拼多多的关键词搜索咱们来看看

发布于:2022-12-27 ⋅ 阅读:(586) ⋅ 点赞:(0)

item_search-根据关键词取商品列表  注册开通

onebound.pinduoduo.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版本

请求参数

请求参数: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 根据关键词取商品列表

请求示例

	
-- 请求示例 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"
}

异常示例

{
  "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 未知错误