淘宝客高级API
淘宝客top100商品人气榜
26571人使用

“TOP100人气榜” 综合精选淘宝实时销量排行榜,均为实时有效数据,该接口领券链接需二次转链!

接口地址: http://api.tbk.dingdanxia.com/spk/top 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

sale_type

Number

1

榜单类型:1 是实时销量榜(近2小时销量),2 是今日爆单榜,3 是昨日爆单榜,4 是出单指数版

cid

Number

0

商品类目:0全部,1女装,2母婴,3美妆,4居家日用,5鞋品,6美食,7文娱车品,8数码家电,9男装,10内衣,11箱包,12配饰,13户外运动,14家装家纺 对应 http://www.dingdanxia.com/doc/21/30 商品分类一级分类 cid

min_id

Number

1

作为请求地址中获取下一页的参数值,默认是1

back

Number

100

每页返回条数(请在1,2,10,20,50,100中选择一个数值返回,最多返回top100条数据)

返回参数说明

标记

类型

例子

说明

min_id

Number

2

作为请求地址中获取下一页的参数值

product_id

Number

2720653

自增ID

itemid

Number

553757100845

宝贝ID

itemtitle

String

南极人魅金创意不锈钢垃圾桶家用卫生间客厅卧室脚踏式厕所带盖筒

宝贝标题

itemshorttitle

String

南极人家用卫生间客厅垃圾袋60个

宝贝短标题

itemdesc

String

南极人加厚垃圾袋60支,采用高强度PE新材料韧性足、无异味、承重佳、封底结实不易漏,避免烂袋尴尬,千万家庭的选择,抢到就是赚!【送运费险】

宝贝推荐语

itemprice

float

8.10

在售价

itemsale

Number

33879

宝贝月销量

itemsale2

Number

5612

宝贝近2小时跑单

todaysale

Number

10493

当天销量

itempic

String

https://img.alicdn.com/imgextra/i2/3412518427/TB26gs7bb7U5uJjSZFFXXaYHpXa_!!3412518427.jpg

宝贝主图原始图像(由于图片原图过大影响加载速度,建议加上后缀_310x310.jpg,如https://img.alicdn.com/imgextra/i2/3412518427/TB26gs7bb7U5uJjSZFFXXaYHpXa_!!3412518427.jpg_310x310.jpg)

itempic_copy

String

0_553757100845_1509175123.jpg

推广长图(带http://img.haodanku.com/0_553757100845_1509175123.jpg-600进行访问)

fqcat

Number

10

商品类目: 1女装,2男装,3内衣,4美妆,5配饰,6鞋品,7箱包,8儿童,9母婴,10居家,11美食,12数码,13家电,14其他,15车品,16文体,17宠物

itemendprice

float

3.10

宝贝券后价

shoptype

String

B

店铺类型: 天猫店(B) 淘宝店(C)

couponurl

String

https://uland.taobao.com/quan/detail??sellerId=3162813958&activityId=1d5771905a774f01ad345d26ad8a55b2

优惠券链接

couponmoney

float

5.6

优惠券金额

videoid

Number

0

商品视频ID(id大于0的为有视频单,视频拼接地址http://cloud.video.taobao.com/play/u/1/p/1/e/6/t/1/+videoid+.mp4)

activity_type

string

普通活动

活动类型: 普通活动 聚划算 淘抢购

planlink

String

https://s.click.taobao.com/KjSknfw

营销计划链接

userid

Number

3162813958

店主的userid

sellernick

String

南极人唯欲专卖店

店铺掌柜名

tkrates

float

70.50

佣金比例

tkmoney

float

2.19

预计可得(宝贝价格 * 佣金比例 / 100)

couponstarttime

Number

1509120000

优惠券开始时间

couponendtime

Number

1509292799

优惠券结束时间

starttime

Number

1509174000

发布时间

general_index

Number

344

好单指数

seller_name

Strng

若梦****追梦

放单人名号

material_id

Strng

15

素材id

short_itemdesc

Strng

让味道留住你卧龙的记忆

导购短语

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
        {
            "product_id": "10639449",
            "itemid": "521264509579",
            "seller_id": "35360",
            "itemtitle": "夏季冰爽女袖防晒手套防紫外线长款冰丝袖套男士护臂手臂套袖袖子",
            "itemshorttitle": "漏洞【2双!4只!】冰爽情侣防晒",
            "itemdesc": "【2对装,实发4只冰袖】男女通用。热卖爆款,100万条带字好评,4.9高评分,清凉冰爽!户外跑步骑车开车购物必备!吸汗透气,买起来~",
            "itemprice": "5.90",
            "itemsale": "936920",
            "itemsale2": "17029",
            "todaysale": "29357",
            "itempic": "http://img.alicdn.com/imgextra/i4/772461325/TB2I0WqiYSYBuNjSspfXXcZCpXa_!!772461325.jpg",
            "itempic_copy": "0_521264509579_1557132242.jpg",
            "fqcat": "5",
            "itemendprice": "2.90",
            "shoptype": "B",
            "tktype": "营销计划",
            "tkrates": "60.00",
            "cuntao": "0",
            "tkmoney": "1.74",
            "couponurl": "http://uland.taobao.com/quan/detail?sellerId=772461325&activityId=5236dbb9fea146c88b4fea61eeb72f33",
            "couponmoney": "3",
            "couponsurplus": "90000",
            "couponreceive": "10000",
            "couponreceive2": "7000",
            "todaycouponreceive": "7000",
            "couponnum": "100000",
            "couponexplain": "单笔满5.0元可用",
            "couponstarttime": "1557849600",
            "couponendtime": "1558108799",
            "start_time": "1557849600",
            "end_time": "1558108799",
            "starttime": "1557849600",
            "isquality": null,
            "report_status": "0",
            "is_brand": "0",
            "is_live": "0",
            "guide_article": "【2对装,实发4只冰袖】男女通用。热卖爆款,100万条带字好评,4.9高评分,清凉冰爽!户外跑步骑车开车购物必备!吸汗透气,买起来~",
            "videoid": "0",
            "activity_type": "普通活动",
            "general_index": "556",
            "planlink": null,
            "seller_name": "超跑联盟",
            "userid": "772461325",
            "sellernick": "卡兰薇旗舰店",
            "shopname": "卡兰薇旗舰店",
            "online_users": "0",
            "original_img": "",
            "original_article": "",
            "discount": "4.90",
            "is_explosion": "0",
            "me": null,
            "activityid": "5236dbb9fea146c88b4fea61eeb72f33",
            "coupon_condition": "5.00",
            "taobao_image": "http://img.alicdn.com/imgextra/i3/772461325/TB2McxtwcuYBuNkSmRyXXcA3pXa_!!772461325.jpg,http://img.alicdn.com/imgextra/i4/772461325/TB2xoaCi49YBuNjy0FfXXXIsVXa_!!772461325.jpg,http://img.alicdn.com/imgextra/i4/772461325/TB2I0WqiYSYBuNjSspfXXcZCpXa_!!772461325.jpg,http://img.alicdn.com/imgextra/i2/772461325/TB2ZSOJi4GYBuNjy0FnXXX5lpXa_!!772461325.jpg,http://img.alicdn.com/imgextra/i3/772461325/TB2DrtkcviSBuNkSnhJXXbDcpXa_!!772461325.jpg",
            "shopid": "69195855",
            "son_category": "50010410",
            "down_type": "0"
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。