# Toutiao API

> China’s news-feed app: full article text, videos, comments and creator accounts.

Canonical page: https://okdata.online/apis/toutiao/

5 endpoints, $0.002 to $0.002 per call. Region: Mainland China. No Toutiao login or cookies needed.

| Endpoint | ID | Returns | Price |
|---|---|---|---|
| [Toutiao article](https://okdata.online/apis/toutiao/articles/get/) | `toutiao.articles.get` | Post | $0.002 per call |
| [Toutiao video](https://okdata.online/apis/toutiao/videos/get/) | `toutiao.videos.get` | Post | $0.002 per call |
| [Toutiao comments](https://okdata.online/apis/toutiao/posts/comments/list/) | `toutiao.posts.comments.list` | Comment[] | $0.002 per call · about 20 comments per page |
| [Toutiao account profile](https://okdata.online/apis/toutiao/users/get/) | `toutiao.users.get` | Account | $0.002 per call |
| [Toutiao hot board](https://okdata.online/apis/toutiao/trends/list/) | `toutiao.trends.list` | Trend[] | $0.002 per call · about 50 board entries per page |

## Good for

- Content research: `toutiao.articles.get`, `toutiao.videos.get`
- Competitor monitoring: `toutiao.articles.get`, `toutiao.videos.get`, `toutiao.users.get`
- Word of mouth: `toutiao.posts.comments.list`
- Creator discovery: `toutiao.users.get`
- Trend research: `toutiao.trends.list`

## At a glance

5 Toutiao endpoints covering articles, videos, posts, accounts and hot lists, from $0.002 a call. No Toutiao account or cookie needed.

Categories: [Social media](https://okdata.online/categories/social/)

- **Endpoints**: 5 endpoints. In 5 groups, one response format.
- **Lowest price**: From $0.002. A call, paid from a prepaid balance.
- **Freshness**: Live. Boards are a shared snapshot up to 10 minutes old.
- **Monthly fee**: $0. No subscription or minimum spend.

- [Start free](https://okdata.online/console/)
- Try one: [Toutiao article](https://okdata.online/apis/toutiao/articles/get/)
- Toutiao in Claude, Cursor and other agents: [Toutiao MCP](https://okdata.online/mcp/toutiao/)

## Endpoints by group

### Articles (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Toutiao article](https://okdata.online/apis/toutiao/articles/get/) | `GET /v1/toutiao/articles/get` | Post | $0.002 per call |

### Videos (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Toutiao video](https://okdata.online/apis/toutiao/videos/get/) | `GET /v1/toutiao/videos/get` | Post | $0.002 per call |

### Posts (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Comments](https://okdata.online/apis/toutiao/posts/comments/list/) | `GET /v1/toutiao/posts/comments/list` | Comment[] | $0.002 per call |

### Accounts (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Account profile](https://okdata.online/apis/toutiao/users/get/) | `GET /v1/toutiao/users/get` | Account | $0.002 per call |

### Hot lists (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Hot board](https://okdata.online/apis/toutiao/trends/list/) | `GET /v1/toutiao/trends/list` | Trend[] | $0.002 per call |

- [Toutiao API pricing](https://okdata.online/pricing/toutiao/)
- [Toutiao in your AI (MCP)](https://okdata.online/mcp/toutiao/)
- [Live status](https://okdata.online/status/)

## What people do with Toutiao data

- [Competitor monitoring](https://okdata.online/solutions/competitor-monitoring/): “What did our competitors post this week, and what took off?” [Toutiao article](https://okdata.online/apis/toutiao/articles/get/) $0.002, [Toutiao video](https://okdata.online/apis/toutiao/videos/get/) $0.002, [Account profile](https://okdata.online/apis/toutiao/users/get/) $0.002
- [Content research](https://okdata.online/solutions/content-research/): “What do the top posts on this topic have in common?” [Toutiao article](https://okdata.online/apis/toutiao/articles/get/) $0.002, [Toutiao video](https://okdata.online/apis/toutiao/videos/get/) $0.002
- [Word of mouth](https://okdata.online/solutions/word-of-mouth/): “What do buyers complain about most?” [Comments](https://okdata.online/apis/toutiao/posts/comments/list/) $0.002
- [Creator discovery](https://okdata.online/solutions/creator-discovery/): “Who are the mid-size creators in camping gear?” [Account profile](https://okdata.online/apis/toutiao/users/get/) $0.002
- [Trend research](https://okdata.online/solutions/trend-research/): “What is trending today that we could ride?” [Hot board](https://okdata.online/apis/toutiao/trends/list/) $0.002

## Start in three steps

1. Get a key: [open the console](https://okdata.online/console/). A new key comes with $0.10 to try, no card.
2. Connect your AI with this sentence (swap in your key), or call the API yourself:

   > Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.

3. Make the first call (Toutiao article). Items arrive in data.items, the next page in page.next_cursor, the charge in meta.billing.amount.

```bash
curl -G "https://api.okdata.online/v1/toutiao/articles/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=7450114952884503059'
```

## Questions about the Toutiao API

### What does the Toutiao API cost?

Each of the 5 endpoints has its own price, $0.002 a call; the cheapest is Toutiao article at $0.002. You pay per call from a prepaid balance, with no subscription. A call that reaches the data source is charged even when it comes back empty, not found or failed; one stopped before that, such as for bad parameters, is free.

### Do I need a Toutiao account or cookie?

No. You call https://api.okdata.online with one okdata key and get public Toutiao data back; you never use your own Toutiao account, cookie or QR login.

### How fresh is the data?

Most endpoints read Toutiao at the moment you call. Hot lists come from a shared snapshot that is at most 10 minutes old.

### Can my AI agent use the Toutiao API?

Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 5 endpoints with their prices, and its call tool runs them on your key.

### Can I try it for free?

New accounts get $0.10 of trial credit with no card: enough for 50 calls to Toutiao article.

## More about Toutiao

- [Comments API](https://okdata.online/roles/posts-comments-list/)
- [Trending topics API](https://okdata.online/roles/trends-list/)
- [Profile API](https://okdata.online/roles/accounts-get/)
- [Post detail API](https://okdata.online/roles/posts-get/)
- [Toutiao hot board: today’s list](https://okdata.online/tools/hot-search/toutiao/)

## Other platforms

[TikTok API](https://okdata.online/apis/tiktok/) · [YouTube API](https://okdata.online/apis/youtube/) · [Instagram API](https://okdata.online/apis/instagram/) · [X (Twitter) API](https://okdata.online/apis/x/) · [Reddit API](https://okdata.online/apis/reddit/) · [Amazon API](https://okdata.online/apis/amazon/) · [AliExpress API](https://okdata.online/apis/aliexpress/) · [Meta Ad Library API](https://okdata.online/apis/meta/) · [Google Ads Transparency API](https://okdata.online/apis/google/) · [Telegram API](https://okdata.online/apis/telegram/) · [Douyin API](https://okdata.online/apis/douyin/) · [Xiaohongshu (RedNote) API](https://okdata.online/apis/xiaohongshu/) · [WeChat Official Accounts API](https://okdata.online/apis/wechat_mp/) · [Bilibili API](https://okdata.online/apis/bilibili/) · [Weibo API](https://okdata.online/apis/weibo/) · [Kuaishou API](https://okdata.online/apis/kuaishou/) · [Zhihu API](https://okdata.online/apis/zhihu/) · [WeChat Channels API](https://okdata.online/apis/wechat_channels/) · [WeChat Search API](https://okdata.online/apis/wechat/) · [Taobao & Tmall API](https://okdata.online/apis/taobao/) · [1688 API](https://okdata.online/apis/alibaba_1688/) · [Xianyu (Goofish) API](https://okdata.online/apis/xianyu/) · [Douyin Shop API](https://okdata.online/apis/douyin_shop/) · [Xigua Video API](https://okdata.online/apis/xigua/) · [Baidu API](https://okdata.online/apis/baidu/) · [Bluesky API](https://okdata.online/apis/bluesky/) · [App Store API](https://okdata.online/apis/app_store/) · [All platforms API](https://okdata.online/apis/all/)
