一、淘宝闲鱼平台按关键词搜索闲鱼商品接口，item_search-按关键字搜索闲鱼商品接口接入说明方案
点击注册获取key和secret测试账号
提取闲鱼关键词搜索商品详情页各项数据，包含skuid、价格、收藏数、加购数、月销售量、主图、标题、详情页图片等参数。
二、建议使用场景
1、商品销售情况分析，根据销量调整活动方案，关联销售，库存准备等等
2、获取商品详情页数据信息
3、商城系统建设
4、代购系统商城建设
5、ERP系统商品选品
三、公共参数说明：
名称 类型 必须 描述
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=女装&page=
参数说明：q:搜索关键字
page:
五、响应参数
名称 类型 示例值 描述
title String HM露肩毛衣 感兴趣的话点“我想要”和我私聊吧～
pic_url String http://img.alicdn.com/bao/uploaded/i4/O1CN01NKG45R1ofvAbqQq42_!!0-fleamarket.jpg 商品图片
promotion_price String 10 优惠价
price String 10 价格
num_iid Bigint 60869458489 商品ID
nick String 尼个腐货 卖家昵称
userAvatarUrl String http://img.alicdn.com/sns_logo/i2/O1CN01LduAme1dNdaZeIpMU_!!0-fleamarket.jpg 卖家头像
area String 店铺所在地
detail_url String https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=632238790257 商品链接
六、请求示例：（CURL、PHP 、PHPsdk 、Java 、C# 、Python…)
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://api.onebound.cn/taobao/demo/sdk2020/demo-sign.php
$method = "GET";
$url = "https://xianyu/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&page=";
$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));
?>
七、响应示例
Result Object:
---------------------------------------
{
"items": {
"keyword": "女装",
"page": 1,
"real_total_results": 1100,
"page_size": 11,
"pagecount": 100,
"item": [
{
"title": "汉服女原创齐腰襦裙交领仙鹤直袖渐变超仙女裙学生古装套装白菜价 新旧程度： 全新 转手原因 ：亏本甩卖衣服尺码：S M L 单件上衣：15元包邮单件裙子：29元包邮上衣+裙子(两件套)：39元包邮(买一送五)另有白色...",
"pic_url": "http://img.alicdn.com/bao/uploaded/i2/O1CN0124f7s51OSvwLpDRBd_!!0-fleamarket.jpg",
"promotion_price": "15",
"price": "15",
"num_iid": "635428435028",
"area": "北京",
"nick": "白菜汉服首饰免费送",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i2/O1CN01eWfaL71OSvwgb9jfK_!!0-fleamarket.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=635428435028"
},
{
"title": "收马甲，开衫，衬衫短袖，长袖（能送沙华吊牌的来） 感兴趣的话点“我想要”和我私聊吧～",
"pic_url": "http://img.alicdn.com/bao/uploaded/i4/O1CN01O5h9Nz1iFv1UnNtS2_!!0-fleamarket.jpg",
"promotion_price": "2",
"price": "2",
"num_iid": "641751022629",
"area": "重庆",
"nick": "小贾昊昊",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i1/O1CN01D6Ges31nKZ4IcDY0g_!!0-fleamarket.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641751022629"
},
{
"title": "没烦恼很幸福 十元一件 打底衫， 上衣 ，淘宝T恤，优衣库t。单买不包邮，跟列表包邮商品一起包邮。",
"pic_url": "http://img.alicdn.com/bao/uploaded/i1/O1CN01iHRASI1TcA1DkTdqu_!!0-fleamarket.jpg",
"promotion_price": "10",
"price": "10",
"num_iid": "642041243209",
"area": "陕西",
"nick": "来魔仙堡放羊",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i2/O1CN01boKgi51g7YYhnsHTW_!!0-fleamarket.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=642041243209"
},
{
"title": "婴儿背带 几乎全新的 60包邮 感兴趣的话点“我想要”和我私聊吧～",
"pic_url": "http://img.alicdn.com/bao/uploaded/i4/O1CN01Vj5tcL1Hg1yi7pfmA_!!0-fleamarket.jpg",
"promotion_price": "60",
"price": "60",
"num_iid": "641047128102",
"area": "广西",
"nick": "茜烯熙夕公主",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i1/O1CN01f2HptJ1aKU23H0Yo8_!!0-fleamarket.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641047128102"
},
{
"title": "新款假两件工服酒吧KTV服务员工作服足浴咖",
"pic_url": "http://g.search.alicdn.com/img/i4/55136360/O1CN01jNV2Gy1wqvdBmxqDn_!!0-saturn_solar.jpg_sum.jpg",
"promotion_price": "70",
"price": "70",
"num_iid": "633390435404",
"area": "福建",
"nick": "",
"userAvatarUrl": "https://gw.alicdn.com/mt/TB1Yiu1snqWBKNjSZFAXXanSpXa-84-84.png",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=633390435404"
},
{
"title": "全新打底衫不加绒春秋 门市到期特价处理只有20件圆领13.8不加绒圆领15.8加绒",
"pic_url": "http://img.alicdn.com/bao/uploaded/i1/O1CN01hTiVvE27bJuHhVVrX_!!0-fleamarket.jpg",
"promotion_price": ".80",
"price": ".80",
"num_iid": "635598868079",
"area": "江苏",
"nick": "优妈小店",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i4/O1CN01vkvtvt23YKqpXKC7b_!!0-fleamarket.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=635598868079"
},
{
"title": "希尔薇 希露薇 cos服装 s码 感兴趣的话点“我想要”和我私聊吧～",
"pic_url": "http://img.alicdn.com/bao/uploaded/i1/O1CN01KXM93W1moxn7PBjyX_!!0-fleamarket.jpg",
"promotion_price": "10",
"price": "10",
"num_iid": "641977743795",
"area": "海南",
"nick": "小船",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i3/6000000008077/O1CN01OaTNwX29XJg5kT2xd_!!6000000008077-0-userheaderimgshow.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641977743795"
},
{
"title": "CR奶油商店原创 CREAM MADE原创 少女病不治 软妹少女玩…颜色分类黑色【男款】尺码均码印花完整都没有开裂穿起来是比较宽松的感觉下摆和袖口略微起球，但我已经处理过了，会粘毛搭配我列表里的另一件黑色短裙穿，会很不错包半邮，...",
"pic_url": "http://img.alicdn.com/bao/uploaded/i1/1714557583/TB2KDDgmPqhSKJjSspnXXc79XXa_!!1714557583.jpg",
"promotion_price": "15",
"price": "15",
"num_iid": "641352417840",
"area": "江西",
"nick": "花秀月",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i4/3299682482/TB2fVQCst0opuFjSZFxXXaDNVXa_!!0-mytaobao.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641352417840"
},
{
"title": "哪吒之魔童降世服装小哪咤衣服cos儿童古装女动漫… 颜色分类大全套(衣服假发枪项圈手镯头箍发带眉心贴）,尺寸140",
"pic_url": "http://img.alicdn.com/bao/uploaded/i3/3102388991/O1CN01xr9hYL2GHvcuyTHtx_!!3102388991.jpg",
"promotion_price": "160",
"price": "160",
"num_iid": "641420741092",
"area": "江苏",
"nick": "辰宝Destiny",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i3/O1CN01efXmN32AxFcZ8qR6a_!!2-mytaobao.png",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641420741092"
},
{
"title": "交换贴互换可换科幻 需要夏天穿的要大码最好是连衣裙~ 好说 话脾气好姐妹们都可以来问问",
"pic_url": "http://img.alicdn.com/bao/uploaded/i4/O1CN016Hbq1o1QkukAmklsu_!!0-fleamarket.jpg",
"promotion_price": "1",
"price": "1",
"num_iid": "641029604732",
"area": "辽宁",
"nick": "欧尼酱酱q",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i4/O1CN01rHlNBo1QkujLNjwI6_!!0-fleamarket.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641029604732"
},
{
"title": "收全新婚纱女孩 神野雫，长期收，慢收 感兴趣的话点“我想要”和我私聊吧～",
"pic_url": "http://img.alicdn.com/bao/uploaded/i3/O1CN019h2nqf1Rlf0EPBKiO_!!0-fleamarket.jpg",
"promotion_price": "1200",
"price": "1200",
"num_iid": "641045644986",
"area": "江苏",
"nick": "用户_77330389",
"userAvatarUrl": "http://img.alicdn.com/sns_logo/i1/377502433/TB2XEgXopXXXXamXXXXXXXXXXXX_!!0-mytaobao.jpg",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/widle-taobao-rax/page-detail?id=641045644986"
}
],
"data_from": "xianyu",
"total_results": ""
},
"error_code": "0000",
"reason": "ok",
"secache": "151256d115bcd683293b2f0f5bdf617b",
"secache_time": 1617262906,
"secache_date": "2021-04-01 15:41:46",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"cache": 0,
"api_info": "today:1 max:10000",
"execution_time": 1.419,
"server_time": "Beijing/2021-04-01 15:41:46",
"client_ip": "106.6.35.196",
"call_args": {
"q": "女装"
},
"api_type": "xianyu",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.54MB",
"request_id": "gw-2.606579396e178"
}
API 工具
API SDK调用示例
APISDK下载
API测试工具
如何开通API测试，点击立即开通