Endpoints by data type
Trending posts API
4 endpoints on 4 platforms return trending posts as the same Post object. The posts a platform ranks as popular or trending right now, hottest first, each with its text, author and counts. A call costs from $0.002 to $0.04, each endpoint at its own price; a failed call is free.
Trending posts · on each platform
| Platform | Endpoint | Path | A page | Price |
|---|---|---|---|---|
| Reddit Popular feed | GET /v1/reddit/popular/posts/list | 10 | $0.002 per call · about 10 posts per page | |
| Douyin | Douyin video boards | GET /v1/douyin/videos/trending | 9 | $0.002 per call · about 9 videos per page |
| Xiaohongshu (RedNote) | Xiaohongshu PGY trending notes | GET /v1/xiaohongshu/pgy/notes/trending | 34 | $0.04 per call · about 34 notes per page |
| Bilibili | Bilibili popular videos | GET /v1/bilibili/videos/trending | 20 | $0.002 per call · about 20 videos per page |
from $0.002 to $0.04 a call, each endpoint at its own price. A call that fails costs nothing.
The object it returns: Post
Every endpoint above returns these fields with the same names and types. A field a platform does not show comes back null and is named in meta.unavailable.
| Field | Type | Meaning |
|---|---|---|
id | string | Post ID on the platform. |
url | string | Link to the post. |
type | string | What kind of post it is. |
title | string | null | Title, where the platform has one (videos, notes, articles). |
text | string | Caption, body or description as plain text; articles come as Markdown. |
lang | string | null | Language code, as reported or detected. |
published_at | string | null | When it was published, ISO 8601 in UTC; null only where the source gives no time (wechat_mp.articles.metrics, wechat_channels.videos.metrics, youtube.channels.videos.list with type=short), then listed in meta.unavailable. |
author | AccountRef | Who posted it. |
metrics | Metrics | Counts at fetch time; a count the platform hides is null. |
images | string[] | null | Image URLs for image posts and notes. |
hashtags | string[] | null | Hashtags or topics, without the # sign. |
ext | object | Platform-specific extras. Only returned with view=full. |
The same call on two platforms
Same parameters, same paging, same response shape. Only the path changes.
# Reddit
curl "https://api.okdata.online/v1/reddit/popular/posts/list" \
-H "Authorization: Bearer $OKDATA_API_KEY"
# Douyin
curl "https://api.okdata.online/v1/douyin/videos/trending" \
-H "Authorization: Bearer $OKDATA_API_KEY"What people use it for
- See which posts are taking off today, not only which topics.
- Save the feed every hour and study what kind of post reaches it.
- Give an AI agent today’s popular posts before it suggests ideas.
Questions
- How is this different from a trending topics board?
- A trending board lists topics or search terms with a rank. This returns the posts themselves, with their text and counts, so you read what is popular instead of guessing from a keyword.
- Can I get yesterday’s feed?
- No. Each call returns the board as it stands now, even where the board itself covers the last few days. To keep a history, call on a schedule and store each result with the time you read it.
- Which platforms have it?
- Only platforms that publish a public popular feed can offer it, and endpoints are added one platform at a time. The table above lists the ones you can call now.