淘宝榜单API - 西瓜猪开放平台

请求参数

Body 参数application/json

back

string

每页返回条数（请在1,2,10,20,50,100中选择一个数值返回）

必需

cid

integer

商品类目

可选

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

minId

string

分页，用于实现类似分页抓取效果，来源于上次获取后的数据的min_id值，默认开始请求值为1（该方案比单纯123分页的优势在于：数据更新的情况下保证不会重复也无需关注和计算页数）

必需

saleType

integer

榜单类型

可选

榜单类型：

1.

实时爆单榜（近2小时销量），

2.

今日爆单榜，

3.

昨日爆单榜，

4.

淘客出单榜，

5.

促活爆单榜

sign

string

接口签名

必需

timeStamp

integer

10位秒级时间戳

必需

示例

{
  "back": "2",
  "cid": 0,
  "minId": "1",
  "saleType": "1",
 "sign": "70a8c1c51f67bda8c48ca95345266139",
  "timeStamp": 1740383544
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/tb/salesList' \
--header 'Content-Type: application/json' \
--data-raw '{
  "back": "2",
  "cid": 0,
  "minId": "1",
  "saleType": "1",
 "sign": "70a8c1c51f67bda8c48ca95345266139",
  "timeStamp": 1740383544
}'

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

data

object

必需

min_id

string

必需

goodsList

array [object {18}]

字段意思参考淘宝搜索接口

必需

message

string

必需

示例

{
  "cache": false,
  "code": 0,
  "data": {
    "min_id": "2",
    "goodsList": [
      {
        "itemid": "yq6rYpMTRt2aweaQNgfoq5SkUA-R76VAveS2N9gwJG8s6",
        "itemtitle": "武夫人腰间盘突出颈椎病肩周炎腱鞘贴膏腰肌劳损膝盖骨质增生药膏",
        "itemdesc": "药监局备案！4.9超高评分100W人见证！有效针对颈椎、腰椎、关节、肩周四大项专贴专用，哪儿痛贴哪儿，效果不虚夸，品质不虚假，电脑上班族、中老年都适合，家中常备，一贴轻松~",
        "itemprice": "89.9",
        "itemsale": "1000000",
        "itempic": "https://img.alicdn.com/imgextra/i4/3423214569/TB2JBcfsWmWBuNjy1XaXXXCbXXa_!!3423214569.jpg",
        "itemendprice": "15.9",
        "shoptype": "B",
        "couponmoney": "70",
        "couponstarttime": "2025-02-24",
        "couponendtime": "2025-02-24",
        "searchSource": "taobao",
        "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/tmicon.png",
        "shopName": "康隆医疗器械专营店",
        "discount": "1.8",
        "fanli": "6.36",
        "tkrates": "40.0",
        "imgs": null
      },
      {
        "itemid": "J09NGWdURtqABNOba6cXKofrUa-dMYxVvdsnjm67pgdHG",
        "itemtitle": "【4件-25】【8件-60】林饱饱纸皮烧麦早餐半成品加热儿童夜宵烧卖",
        "itemdesc": "加码了！新增4个口味！折1.6亓/只！！\n怪不得叫纸皮烧麦呢，皮薄的几乎没有存在感\n林饱饱官旗，任选④件，到手共16只\n",
        "itemprice": "300.8",
        "itemsale": "70000",
        "itempic": "http://img-haodanku-com.cdn.fudaiapp.com/0_758881173907_1738990935.jpg",
        "itemendprice": "26.8",
        "shoptype": "B",
        "couponmoney": "274",
        "couponstarttime": "2025-02-24",
        "couponendtime": "2025-02-26",
        "searchSource": "taobao",
        "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/tmicon.png",
        "shopName": "林饱饱旗舰店",
        "discount": "0.9",
        "fanli": "5.36",
        "tkrates": "20.0",
        "imgs": null
      }
    ]
  },
  "message": "操作成功"
}