# 热门内容榜 API

3 个平台的 3 个接口返回同一种 Post（内容）对象。平台此刻排出来的热门内容。每次调用 $0.0020；失败不收费。

## 各平台的热门内容榜接口

| 平台 | 接口 | 路径 | 一页 | 返回 | 价格 |
| --- | --- | --- | --- | --- | --- |
| B站 | [B站综合热门](https://dataxapi.com/zh/apis/bilibili/videos/trending.md) | `GET /v1/bilibili/videos/trending` | 20 | 内容列表 | $0.0020 / 次 |
| 抖音 | [抖音视频榜](https://dataxapi.com/zh/apis/douyin/videos/trending.md) | `GET /v1/douyin/videos/trending` | 10 | 内容列表 | $0.0020 / 次 |
| Reddit | [Reddit 热门帖子](https://dataxapi.com/zh/apis/reddit/posts/trending.md) | `GET /v1/reddit/posts/trending` | 25 | 内容列表 | $0.0020 / 次 |

价格是现行价格。失败和结果不确定的调用不收费。

## Post（内容）对象

上面每个接口返回的都是这些字段，名字和类型都一样。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | 文本 | 编号，可原样传给取详情的接口 |
| `url` | 链接 | 能直接打开的链接 |
| `type` | 文本 | 内容形态 |
| `title` | 文本 | 标题 |
| `text` | 文本 | 正文 |
| `lang` | 文本 | 正文的语言 |
| `published_at` | 时间 | 发布时间 |
| `author.id` | 文本 | 作者的账号编号 |
| `author.username` | 文本 | 作者的账号名 |
| `author.name` | 文本 | 作者的显示名 |
| `author.avatar_url` | 链接 | 作者头像 |
| `author.verified` | 是否 | 作者是否认证 |
| `author.followers` | 整数 | 作者的粉丝数 |
| `metrics.likes` | 整数 | 点赞数 |
| `metrics.comments` | 整数 | 评论数 |
| `metrics.shares` | 整数 | 分享数 |
| `metrics.favorites` | 整数 | 收藏数 |
| `metrics.views` | 整数 | 播放或阅读数 |
| `metrics.reposts` | 整数 | 转发数 |
| `images` | 链接列表 | 图片地址 |
| `hashtags` | 文本列表 | 话题标签，不带 # |
| `mentions[].id` | 文本 | 账号编号 |
| `mentions[].username` | 文本 | 账号名 |
| `mentions[].name` | 文本 | 显示名 |
| `is_pinned` | 是否 | 是否被作者置顶 |
| `post_id` | 文本 | 它回复的那条内容所在的主帖编号；不是回复则为 null |
| `parent_id` | 文本 | 它直接回复的那一条的编号；不是回复则为 null |
| `root_id` | 文本 | 所在回复串里第一层那一条的编号 |

[看这个对象的页面 →](https://dataxapi.com/zh/docs/objects/post/)

### 哪个平台有哪个字段

接口给不了的字段，每次返回都会写在 `meta.unavailable` 里，所以缺字段不会是意外。

| 平台 | `title` | `lang` | `author.id` | `author.username` | `author.name` | `author.verified` | `author.followers` | `metrics.likes` | `metrics.comments` | `metrics.shares` | `metrics.favorites` | `metrics.views` | `metrics.reposts` | `images` | `hashtags` | `mentions[].id` | `mentions[].username` | `mentions[].name` | `is_pinned` | `post_id` | `parent_id` | `root_id` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| B站 | 有 | 给不了 | 有 | 给不了 | 有 | 给不了 | 给不了 | 有 | 有 | 有 | 有 | 有 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 |
| 抖音 | 给不了 | 给不了 | 给不了 | 给不了 | 有 | 给不了 | 有 | 有 | 给不了 | 给不了 | 给不了 | 有 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 | 给不了 |
| Reddit | 有 | 有 | 有 | 有 | 给不了 | 给不了 | 给不了 | 给不了 | 有 | 有 | 给不了 | 给不了 | 给不了 | 有 | 给不了 | 给不了 | 给不了 | 给不了 | 有 | 给不了 | 给不了 | 给不了 |

## 同一次调用，换一个平台

同样的参数名，同样的翻页，同样的返回。变的只有路径。

```bash
# B站
curl "https://api.dataxapi.com/v1/bilibili/videos/trending" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# 抖音：只改一个词
curl "https://api.dataxapi.com/v1/douyin/videos/trending" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

### 200 · application/json

B站综合热门：取自 2026-10-12 18:47 UTC 录下的真实返回。名字、正文和编号是示例，链接也是，都不是录到的原文（页面不展示任何人的个人信息）；数字是原样。长列表做了截断。请求号、游标和余额是示意。

```jsonc
{
  "code": "ok",
  "request_id": "60b60580-f1ff-445d-a6b4-2d76325b4262",
  "data": {
    "items": [
      {
        "id": "BV1DkNMJ43KM",
        "url": "https://www.bilibili.com/video/BV1DkNMJ43KM",
        "type": "video",
        "title": "周末露营入门指南：一篇讲清楚",
        "text": "周末露营｜第一次尝试就爱上了，清单放评论区",
        "published_at": "2026-10-12T03:00:00.000Z",
        "author": {
          "id": "569825848",
          "name": "阿杰爱折腾",
          "avatar_url": "https://i0.hdslb.com/bfs/face/9cd4eb4b4b98a5c2bd794f22.jpg"
        },
        "metrics": {
          "likes": 42209,
          "comments": 586,
          "shares": 1059,
          "favorites": 13144,
          "views": 536856
        }
      },
      // … 另有 19 条
    ]
  },
  "page": {
    "next_cursor": "c1.nghwkdlhEqXHhpdfs7t1YBoqa3EGmjFKgI_Zgcz3",
    "cursor_expires_at": "2026-10-12T19:47:38.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "bilibili.videos.trending",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:47:38.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "lang": "capability",
      "author.username": "platform",
      "author.verified": "capability",
      "author.followers": "capability",
      "metrics.reposts": "platform",
      "images": "platform",
      "hashtags": "capability",
      "mentions": "capability",
      "is_pinned": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}
```

## 返回的是什么

- [Post（内容）对象](https://dataxapi.com/zh/docs/objects/post/): 字段 28, 返回它的接口 81, 平台 19

## 关于 热门内容榜 API 的常见问题

### 多少钱？

B站、抖音、Reddit每次 $0.0020。拿到数据才扣费，失败不收。没有订阅，没有月最低消费。

### 怎么取完所有页？

把 `page.next_cursor` 原样当作 `cursor` 传回去，直到 `page.has_more` 为 false。每一页是一次调用，价格相同。

### 每个平台的字段都全吗？

不全。28 个字段里有 22 个至少在一个平台上拿不到，本页的对照表写明是哪些。接口给不了的字段，每次返回都写在 `meta.unavailable` 里，不会用猜的数顶上。

### 需要平台账号吗？

不需要。一把 DataXAPI 的 Key 读这 3 个平台，不用任何平台的账号，也不用 Cookie。

## 其他数据类型

[评论回复 API](https://dataxapi.com/zh/roles/comments-replies-list/)、[话题下的内容 API](https://dataxapi.com/zh/roles/topics-posts-list/)、[热榜 API](https://dataxapi.com/zh/roles/trends-list/)、[账号资料 API](https://dataxapi.com/zh/roles/accounts-get/)、[账号作品列表 API](https://dataxapi.com/zh/roles/accounts-posts-list/)、[评论 API](https://dataxapi.com/zh/roles/posts-comments-list/)、[内容详情 API](https://dataxapi.com/zh/roles/posts-get/)、[内容搜索 API](https://dataxapi.com/zh/roles/posts-search/)、[账号搜索 API](https://dataxapi.com/zh/roles/accounts-search/)、[内容互动数据 API](https://dataxapi.com/zh/roles/posts-metrics/)、[社区帖子 API](https://dataxapi.com/zh/roles/communities-posts-list/)、[广告详情 API](https://dataxapi.com/zh/roles/ads-get/)、[广告主的广告 API](https://dataxapi.com/zh/roles/advertisers-ads-list/)、[广告主搜索 API](https://dataxapi.com/zh/roles/advertisers-search/)、[广告库搜索 API](https://dataxapi.com/zh/roles/ads-search/)、[视频转文字 API](https://dataxapi.com/zh/roles/transcripts-get/)、[粉丝列表 API](https://dataxapi.com/zh/roles/accounts-followers-list/)、[社区资料 API](https://dataxapi.com/zh/roles/communities-get/)、[商品详情 API](https://dataxapi.com/zh/roles/products-get/)、[商品评价 API](https://dataxapi.com/zh/roles/products-reviews-list/)、[商品搜索 API](https://dataxapi.com/zh/roles/products-search/)、[达人搜索 API](https://dataxapi.com/zh/roles/creators-search/)、[达人资料 API](https://dataxapi.com/zh/roles/creators-get/)、[达人粉丝画像 API](https://dataxapi.com/zh/roles/creators-audience-get/)、[达人数据表现 API](https://dataxapi.com/zh/roles/creators-metrics/)、[达人作品 API](https://dataxapi.com/zh/roles/creators-posts-list/)、[全部 21 个平台 →](https://dataxapi.com/zh/apis/)

---

最后核对于 2026-10-21 11:10 UTC。目录修订号 c48ce454ae6c4c65。 [网页版](https://dataxapi.com/zh/roles/posts-trending/)
