# Trending posts API

3 endpoints on 3 platforms return the same Post object. The posts a platform ranks as popular now. Every call costs $0.0020; a failed call is free.

## Trending posts on each platform

| Platform | Endpoint | Path | A page | Returns | Price |
| --- | --- | --- | --- | --- | --- |
| Bilibili | [Bilibili popular videos](https://dataxapi.com/apis/bilibili/videos/trending.md) | `GET /v1/bilibili/videos/trending` | 20 | Post list | $0.0020 / call |
| Douyin | [Douyin trending videos](https://dataxapi.com/apis/douyin/videos/trending.md) | `GET /v1/douyin/videos/trending` | 10 | Post list | $0.0020 / call |
| Reddit | [Reddit popular posts](https://dataxapi.com/apis/reddit/posts/trending.md) | `GET /v1/reddit/posts/trending` | 25 | Post list | $0.0020 / call |

Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.

## The Post object

Every endpoint above returns these fields, with the same names and types.

| Field | Type | Description |
| --- | --- | --- |
| `id` | text | ID; pass it unchanged to the get endpoint |
| `url` | link | Link that opens the post |
| `type` | text | Content format |
| `title` | text | Title |
| `text` | text | Body text |
| `lang` | text | Language of the text |
| `published_at` | time | When it was published |
| `author.id` | text | Author's account ID |
| `author.username` | text | Author's handle |
| `author.name` | text | Author's display name |
| `author.avatar_url` | link | Author's avatar |
| `author.verified` | yes/no | Whether the author is verified |
| `author.followers` | integer | Author's follower count |
| `metrics.likes` | integer | Likes |
| `metrics.comments` | integer | Comments |
| `metrics.shares` | integer | Shares |
| `metrics.favorites` | integer | Saves |
| `metrics.views` | integer | Views |
| `metrics.reposts` | integer | Reposts |
| `images` | list of link | Image addresses |
| `hashtags` | list of text | Hashtags, without the # |
| `mentions[].id` | text | Account ID |
| `mentions[].username` | text | Handle |
| `mentions[].name` | text | Display name |
| `is_pinned` | yes/no | Whether the author pinned it |
| `post_id` | text | ID of the thread's root post when this is a reply; otherwise null |
| `parent_id` | text | ID of the item it replies to directly; otherwise null |
| `root_id` | text | ID of the first-level reply its thread hangs under |

[The object's own page →](https://dataxapi.com/docs/objects/post/)

### Which platform fills which field

A field an endpoint cannot give is listed in `meta.unavailable` on every answer, so a gap is never a surprise.

| Platform | `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` |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Bilibili | available | not available | available | not available | available | not available | not available | available | available | available | available | available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available |
| Douyin | not available | not available | not available | not available | available | not available | available | available | not available | not available | not available | available | not available | not available | not available | not available | not available | not available | not available | not available | not available | not available |
| Reddit | available | available | available | available | not available | not available | not available | not available | available | available | not available | not available | not available | available | not available | not available | not available | not available | available | not available | not available | not available |

## The same call on two platforms

Same parameter names, same paging, same answer. Only the path changes.

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

# Douyin: one word changes
curl "https://api.dataxapi.com/v1/douyin/videos/trending" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

### 200 · application/json

Bilibili popular videos: From a response recorded 2026-10-12 18:47 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

```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 more
    ]
  },
  "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"
    }
  }
}
```

## What comes back

- [The Post object](https://dataxapi.com/docs/objects/post/): Fields 28, Endpoints that return it 81, Platforms 19

## Questions about the Trending posts API

### How much does it cost?

$0.0020 a call on Bilibili, Douyin, Reddit. You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum.

### How do I get every page?

Pass `page.next_cursor` back as `cursor` until `page.has_more` is false. Each page is one call at the same price.

### Does every platform fill every field?

No. 22 of the 28 fields are missing on at least one platform; the table on this page says which. A field an endpoint cannot give is named in `meta.unavailable` on every answer, never filled with a guess.

### Do I need an account on the platform?

No. One DataXAPI key reads all 3 platforms. No platform account and no cookie.

## Other data types

[Comment replies API](https://dataxapi.com/roles/comments-replies-list/), [Hashtag posts API](https://dataxapi.com/roles/topics-posts-list/), [Trending topics API](https://dataxapi.com/roles/trends-list/), [Account profile API](https://dataxapi.com/roles/accounts-get/), [Account posts API](https://dataxapi.com/roles/accounts-posts-list/), [Comments API](https://dataxapi.com/roles/posts-comments-list/), [Post detail API](https://dataxapi.com/roles/posts-get/), [Post search API](https://dataxapi.com/roles/posts-search/), [Account search API](https://dataxapi.com/roles/accounts-search/), [Post metrics API](https://dataxapi.com/roles/posts-metrics/), [Community posts API](https://dataxapi.com/roles/communities-posts-list/), [Ad detail API](https://dataxapi.com/roles/ads-get/), [Advertiser ads API](https://dataxapi.com/roles/advertisers-ads-list/), [Advertiser search API](https://dataxapi.com/roles/advertisers-search/), [Ad library search API](https://dataxapi.com/roles/ads-search/), [Video transcript API](https://dataxapi.com/roles/transcripts-get/), [Followers API](https://dataxapi.com/roles/accounts-followers-list/), [Community profile API](https://dataxapi.com/roles/communities-get/), [Product detail API](https://dataxapi.com/roles/products-get/), [Product reviews API](https://dataxapi.com/roles/products-reviews-list/), [Product search API](https://dataxapi.com/roles/products-search/), [Creator search API](https://dataxapi.com/roles/creators-search/), [Creator profile API](https://dataxapi.com/roles/creators-get/), [Creator audience API](https://dataxapi.com/roles/creators-audience-get/), [Creator metrics API](https://dataxapi.com/roles/creators-metrics/), [Creator posts API](https://dataxapi.com/roles/creators-posts-list/), [All 21 platforms →](https://dataxapi.com/apis/)

---

Last checked 2026-10-21 11:10 UTC. Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/roles/posts-trending/)
