3 淘宝排名查询 API 接口介绍

请先 登录 后评论

1 个回答

凯文

一,接口文档

接口密钥: Account和Accessskey是用于您访问API的密钥,具有该接口的权限,请妥善保管

淘宝排名查询

接口地址: http://doc.vv-tool.com/taobao/itemrank

接口介绍: 模拟手淘(或者 pc 端)未登陆账号显示指定商品的搜索词下的排名   薇心:vtgjaz

一、接口介绍

查询商品在指定关键词下的排名情况,商家推广过程中,需要实时掌握商品排名变化,以此来检测推广效果。手动在淘宝搜索页翻查排名,如果商品排名靠后,查找会耗费大量时间,查找过程也很痛苦,而且本地电脑会受到缓存,个性化,千人千面等影响,不利于真实排名的获取。v兔工具实时自动查询未登陆账号显示指定商品的搜索词下的排名,还原买家搜索结果。服务器查询速度快,100页只需几秒钟,节省了大量时间提高工作效率

二、接口使用场景

一个商品在指定关键词下真实的排名情况未知,希望能找到商品在哪一页

三、接口效果

排除干扰因素,实现了在无账号登录状态下,获取商品在搜索关键词下最真实有效的排名情况

四、接口详情

支持的终端:手淘APP,淘宝PC

排序方式:手淘APP:默认,人气,销量,信用,最新,价格升,价格降

                  淘宝PC:默认,销量,价格升,价格降     

筛选条件:手淘APP(所有宝贝):免运费,天猫,全球购,消费者保障,手机专享价,淘金币,货到付款,七天退换,促销

                  淘宝PC(所有宝贝):包邮,赠送退货运费险,货到付款,海外商品,二手,天猫,正品保证,24 小时内发货,7+ 天内退货,旺旺在线,信用卡支付,折扣促销,新品

                  淘宝PC(天猫宝贝):包邮,赠送退货运费险,货到付款,海外商品,二手,正品保证,24 小时内发货,旺旺在线,信用卡支付,折扣促销,新品

需提供信息:商品链接

                      查询商品的关键词 

结果显示:商品出现在前100页的具体页数

                  商品未出现在前100页

收费内容该接口按月收费,不限制请求次数,甚至免费。详细可以联系工作人员开通接口

五、接口的常见问题

暂无

请求方式: POST

传参方式: form-data

返回格式: JSON

接口收费: 已满,包年包月

频率限制: 10 次/秒

请求头参数

Authorizationstring授权 access_tokenBearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请求参数

mediaint0 为手淘,1 为 PC 会影响 tagId 的设置和 sort 设置
sortintmedia 为 0 时,可选值:0-默认,1-人气,2-销量,3-信用,4-最新,5-价格升,6-价格降,media 为 1 时,可选值:0-默认,2-销量,5-价格升,6-价格降
patternint1:精准
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
请先 登录 后评论
  • 1 关注
  • 0 收藏,971 浏览
  • 提出于 10/13/2020 23:52:29

相似问题