item_search-根据关键词取商品列表 [查看演示] API测试工具
onebound.pinduoduo.item_search
公共参数
请求地址: https://api-gw.onebound.cn/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 | 未知错误 | 否 |
API 工具