一 、为什么要使用淘宝排名查询
在网店上架一个商品时，商品的标题就尤为的重要。怎样做才能让购买者更容易的搜索的自己的商品，哪些词比较吸引客户，这时你就可以把自己选出来的关键词来查询一下，他在同类目下的排名
二、接口效果
排除干扰因素，实现了在无账号登录状态下，获取商品在搜索关键词下最真实有效的排名情况
三、接口详情
淘宝排名查询
接口地址： http://xxxx.com/tool/accounts/item-rank,违心：juzivtu
接口介绍： 模拟手淘（或者 pc 端）未登陆账号显示指定商品的搜索词下的排名 点击查看详情,违心：juzivtu
请求方式： POST
传参方式： form-data
返回格式： JSON
接口收费： 已满，包年包月
频率限制： 10 次/秒
请求头参数
参数类型必选值示例Authorizationstring是授权 access_tokenBearer 1798c6aadec33d1bc2f5b707f1049aefexxxx
请求参数
参数类型必选描述mediaint是0 为手淘，1 为 PC 会影响 tagId 的设置和 sort 设置sortint是media 为 0 时，可选值：0-默认，1-人气，2-销量，3-信用，4-最新，5-价格升，6-价格降，media 为 1 时，可选值：0-默认，2-销量，5-价格升，6-价格降patternint是1：精准keywordstring是搜索词item_idstring是商品链接start_pageint是开始查找的页码page_stepint否默认为一次 2 页，最大一次 3 页，假设第 1 页开始，设置为 2，则查找 1、2 页，数据不保证 100% 返回，可能返回为空，需要自己的程序里加入判断逻辑；如果没有返回，或者只返回一部分，没返回的需要重新请求，返回的请求是连续的tag_idint否选择 PC 且为所有宝贝(all)时，可选值：0-包邮，1-赠送退货运费险，2-货到付款，3-海外商品，4-二手，5-天猫，6-正品保证，7-24 小时内发货，8-7+ 天内退货，9-旺旺在线，10-信用卡支付,11-折扣促销，12-新品 ；选择 PC 且为天猫时(tmall)，可选值：0-包邮，1-赠送退货运费险，2-货到付款，3-海外商品，4-二手，6-正品保证，7-24 小时内发货，9-旺旺在线，10-信用卡支付,11-折扣促销，12-新品；选择无线时(不管所有宝贝还是天猫)，可选值：13-免运费，14-天猫，15-全球购，16-消费者保障，17-手机专享价，18-淘金币，19-货到付款，20-七天退换，21-促销typestring否会影响 tag_id 的设置 默认为 all 、tmall，选择 PC 且为所有宝贝时
请求示例
media：1
sort：0
pattern：1
keywor：好欢螺
item_id: https://detail.tmall.com/item.htm?id=604618443394&ali_trackid=2:mm_124190590_30248727_109212350230:1596447162_115_871152963&spm=a231o.7712113/g.1004.338&pvid=200_11.8.64.128_4701_1596447149036&bxsign=tbk1596447162349fad57f7d8f659cc9f697b3b32d70e180
start_page: 1
page_step: 3
tag_id: 0
type：tmall
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
参数类型描述dataobject返回数据信息totalpageint总页数startpageint开始页码nextpageint下一页pagestepint查询页码尾数itemsstring商品信息codeint返回状态码msgstring返回码描述msecint接口执行时间timeint接口返回时间
返回数据
{
“code”: 0,
“msg”: “获取排名数据成功”,
“msec”: 4265,
“time”: 1596449461,
“data”: {
“info”: {
“totalpage”: 37,
“startpage”: 1,
“nextpage”: 4,
“pagestep”: 3
},
“data”: {
“items”: [
{
“id”: “604618443394”,
“pos”: 20,
“page”: 2,
“title”: “好欢螺螺蛳粉300g*10袋礼盒装螺丝粉广西柳州螺狮粉正宗整箱包邮”,
“nick”: “迅荟食品专营店”,
“url”: “https://item.taobao.com/item.htm?id=604618443394”,
“img”: “http://g.search2.alicdn.com/img/bao/uploaded/i4/i2/3400066719/O1CN01K386yS1zVLj5tJsAw_!!3400066719.jpg”,
“isp4p”: 0,
“view_sales”: 5808,
“category”: null,
“price”: “38.70”,
“area”: “广西 柳州”,
“seller_type”: “1”,
“seller_level”: null
}
]
}
}
}
响应代码
代码代码描述解决方案0成功100请求参数错误检查您的请求参数是否正确101请求超时检查您的参数或者网络连接情况或联系客服解决200系统错误，请联系客服检查您的接口地址填写是否正确，其他问题联系客服解决203暂不支持当前接口204请求异常：无该接口权限，请前往官网开通正式接口。前往官网开通该接口权限204请求异常：API 调用次数不足,请前往网站兑换次数。前往官网充值该接口调用次数401身份凭证无效在请求头中添加 access_token
