当前位置：网站首页>关键字搜索：“淘宝商品 API ”
关键字搜索：“淘宝商品 API ”
2022-08-01 21:02:00 【分享干货的猫】
一、参数 注册获取专属于你的key和secret
公共参数
请求地址: https://api-gw.onebound.cn/taobao/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=&seller_info=&nick=&ppath=&imgid=&filter=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:页数
响应参数
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
title | String | 0 | 法式复古山本超仙chic仙女赫本网红初春很仙法国小众裙子两件套装 | 商品标题 |
pic_url | String | 0 | //img.alicdn.com/bao/uploaded/i3/3083218865/O1CN012FMDaiwxkenJGaM_!!0-item_pic.jpg | 宝贝图片 |
promotion_price | Float | 0 | 178.00 | 优惠价 |
price | Float | 0 | 178.00 | 价格 |
sales | Int | 0 | 890 | 销量 |
num_iid | Bigint | 0 | 577437133060 | 宝贝ID |
sample_id | String | 0 | 商品风格标识ID | |
seller_nick | String | 0 | 初穆旗舰店 | 掌柜昵称 |
post_fee | Float | 0 | 10.00 | 物流费用 |
area | String | 0 | 山东 | 店铺所在地 |
detail_url | String | 0 | //detail.tmall.com/item.htm?id=586794298909&ns=1&abbucket=0 | 宝贝链接 |
seller_info | Mix | 0 | {"level": 99, "shop_type": "B", "user_num_id": "2217148345", "cid": 0, "delivery_score": "", "item_score": "", "score_p": ""} | 卖家信息 |
二、示例
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/taobao/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=女装&start_price=0&end_price=0&page=1&cat=0&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=&imgid=&filter="
注册获取专属于你的key和secret
响应示例
---------------------------------------
{
"page": "1",
"page_no": "1",
"real_total_results": "3734231",
"total_results": "3734231",
"page_size": "10",
"pagecount": "100",
"item": [
{
"title": "清仓捡漏专柜撤回正品女装外贸t恤短袖2022新款夏设计感大码上衣",
"pic_url": "https://img.alicdn.com/bao/uploaded/i4/3245823593/O1CN01giQTBP1cPdfCJOpII_!!0-item_pic.jpg",
"promotion_price": "9.95",
"price": "9.95",
"sales": "800+",
"num_iid": "618346579721",
"seller_nick": "飘莉芬旗舰店",
"area": "广东 广州",
"seller_id": "3245823593",
"detail_url": "https://detail.tmall.com/item.htm?id=618346579721&skuId=4382887825548&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.0"
},
{
"title": "史努比短袖t恤女2022夏季新款oversize宽松学生半袖卡通上衣ins潮",
"pic_url": "https://img.alicdn.com/bao/uploaded/i3/2210899870446/O1CN01GhG6X91FAJOf2zYR3_!!0-item_pic.jpg",
"promotion_price": "10.9",
"price": "10.9",
"sales": "600+",
"num_iid": "673857603034",
"seller_nick": "荆懿旗舰店",
"area": "广东 广州",
"seller_id": "2210899870446",
"detail_url": "https://detail.tmall.com/item.htm?id=673857603034&skuId=4844077676113&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.1"
},
{
"title": "2022新款冰丝阔腿裤女宽松垂感高腰夏季薄款九分休闲直筒裤子夏天",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2177707621/O1CN01acG4Ph26AT5Kin9Hj_!!0-item_pic.jpg",
"promotion_price": "17.9",
"price": "17.9",
"sales": "100+",
"num_iid": "619413775589",
"seller_nick": "南极人神电专卖店",
"area": "浙江 金华",
"seller_id": "2177707621",
"detail_url": "https://detail.tmall.com/item.htm?id=619413775589&skuId=4540899494610&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.2"
},
{
"title": "大码女装夏装胖妹妹气质显瘦别致不规则中长款白衬衫微喇裤两件套",
"pic_url": "https://img.alicdn.com/bao/uploaded/i2/2207370049106/O1CN017iuOJg2H8bL24fz7x_!!0-item_pic.jpg",
"promotion_price": "98.0",
"price": "98.0",
"sales": "700+",
"num_iid": "677690141586",
"seller_nick": "妍茹蕴旗舰店",
"area": "广东 广州",
"seller_id": "2207370049106",
"detail_url": "https://detail.tmall.com/item.htm?id=677690141586&skuId=4868124917690&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.3"
},
{
"title": "清仓捡漏专柜撤回正品女装外贸白色短袖t恤夏设计感小众上衣ins潮",
"pic_url": "https://img.alicdn.com/bao/uploaded/i3/3245823593/O1CN01ZmZag41cPdf7kKMP7_!!0-item_pic.jpg",
"promotion_price": "9.95",
"price": "9.95",
"sales": "400+",
"num_iid": "617387861087",
"seller_nick": "飘莉芬旗舰店",
"area": "广东 广州",
"seller_id": "3245823593",
"detail_url": "https://detail.tmall.com/item.htm?id=617387861087&skuId=4358001749756&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.4"
},
{
"title": "薄款仙气棉麻连衣裙女2022年春夏季新款休闲减龄国际大牌亚麻裙子",
"pic_url": "https://img.alicdn.com/bao/uploaded/i2/2895242679/O1CN01UyxEGF1Vf1khvu62Q_!!0-item_pic.jpg",
"promotion_price": "59.9",
"price": "59.9",
"sales": "36",
"num_iid": "649760276156",
"seller_nick": "雅宝翡丽旗舰店",
"area": "广东 广州",
"seller_id": "2895242679",
"detail_url": "https://detail.tmall.com/item.htm?id=649760276156&skuId=4863704495928&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.5"
},
{
"title": "2022夏季新款纯棉修身超a上衣高腰网红短袖短款t恤女ins潮酷",
"pic_url": "https://img.alicdn.com/bao/uploaded/i3/4000223766/O1CN01PH5FVn1dgsKx97ppX_!!0-item_pic.jpg",
"promotion_price": "5.9",
"price": "5.9",
"sales": "700+",
"num_iid": "612454928242",
"seller_nick": "施素旗舰店",
"area": "广东 广州",
"seller_id": "4000223766",
"detail_url": "https://detail.tmall.com/item.htm?id=612454928242&skuId=4315137253303&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.6"
},
{
"title": "休闲运动套装女2022年夏季新款时尚大码女装夏装短袖两件套夏天潮",
"pic_url": "https://img.alicdn.com/bao/uploaded/i3/2999135564/O1CN01SVOMVo1qyMJpJ31lo_!!2999135564-0-lubanu-s.jpg",
"promotion_price": "76.0",
"price": "76.0",
"sales": "200+",
"num_iid": "616286059137",
"seller_nick": "韩菲依饰旗舰店",
"area": "福建 泉州",
"seller_id": "2999135564",
"detail_url": "https://detail.tmall.com/item.htm?id=616286059137&skuId=4342571465199&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.7"
},
{
"title": "韩版洋气百搭卡通印花短袖t恤女2022新款宽松大码中长款夏季上衣",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/4023193621/O1CN01BSKOKQ1ccSkjtOOUG_!!4023193621-0-lubanu-s.jpg",
"promotion_price": "9.95",
"price": "9.95",
"sales": "400+",
"num_iid": "618501415158",
"seller_nick": "沿花小筑旗舰店",
"area": "广东 广州",
"seller_id": "4023193621",
"detail_url": "https://detail.tmall.com/item.htm?id=618501415158&skuId=4363986133619&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.8"
},
{
"title": "欧美原创设计感纯棉短袖t恤女ins潮2022夏季新款韩系chic港味上衣",
"pic_url": "https://img.alicdn.com/bao/uploaded/i4/3597026214/O1CN01zo7QVk1vm3vCYYKxe_!!0-item_pic.jpg",
"promotion_price": "15.6",
"price": "15.6",
"sales": "2000+",
"num_iid": "674859178825",
"seller_nick": "rosetears玫瑰泪旗舰店",
"area": "浙江 杭州",
"seller_id": "3597026214",
"detail_url": "https://detail.tmall.com/item.htm?id=674859178825&skuId=5024074682909&channelTraceId=search_212072be16593178138022000e66cf&spm=a1z60.7754815.item.9"
}
],
"data_from": "tianmiao",
"error": "",
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:27 max:10100 all[43=27+4+12];expires:2030-12-31",
"execution_time": "1.589",
"server_time": "Beijing/2022-08-01 09:36:54",
"client_ip": "106.6.35.126",
"call_args": [],
"api_type": "taobao",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "5.84MB",
"request_id": "gw-1.62e72e354ba96",
"last_id": "1119505524"
}异常示例
三、错误码解释
| 状态代码(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 | 未知错误 | 否 |
边栏推荐
猜你喜欢
Internet使用的网络协议是什么
C语言之字符串函数二
Little data on how to learn?Jida latest small learning data review, 26 PDF page covers the 269 - page document small data learning theory, method and application are expounded
用户身份标识与账号体系实践
关于Request复用的那点破事儿。研究明白了，给你汇报一下。
Remove 360's detection and modification of the default browser
WeChat applet cloud development | personal blog applet
宝塔搭建PESCMS-Ticket开源客服工单系统源码实测
函数（二）
wps excel 插入公式 整列
随机推荐
微服务负载均衡器Ribbon
C语言之字符串函数二
进行交互或动画时如何选择Visibility, Display, and Opacity
列表页常见的 hook 封装
技能大赛训练：A部分加固题目
C陷阱与缺陷 第8章 建议与答案 8.1 建议
Pytorch框架学习记录9——非线性激活
30+的女性测试人面试经验分享
数据库内核面试中我不会的问题(1)
乐观锁批量跟新 纯SQL
线上问题排查常用命令，总结太全了，建议收藏！！
C专家编程 第1章 C：穿越时空的迷雾 1.2 C语言的早期体验
OSG笔记：设置DO_NOT_COMPUTE_NEAR_FAR，手动计算远近平面
那些关于DOM的常见Hook封装（二）
C陷阱与缺陷 第8章 建议与答案 8.2 答案
算法---解码方法（Kotlin）
函数（二）
面试突击70：什么是粘包和半包？怎么解决？
Custom command to get focus
tiup mirror genkey