Toutiao API
Read Toutiao 今日头条 articles with full text, videos and comments from article and video IDs or links. Get titles, text, images, read, like and comment counts, authors and IP location. No login or cookies needed. Export to JSON, CSV or Excel.
Toutiao API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 3 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.00368 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
3 kinds of Toutiao request
Toutiao (今日头条) is one of China's largest news and content apps, run by ByteDance. Publishers, media outlets and independent writers post articles, videos and short posts there, and readers comment under them.
A real run, 25 fields per record
Run on 2026-10-28 with input {"mode": "article", "posts": ["https://www.toutiao.com/article/7700872920532320803/"], "maxResults": 3}. Personal fields of ordinary users are masked here.
| title | authorName | text | imageCount | publishedAt | publishLocation |
|---|---|---|---|---|---|
| 高盛预测中国楼市:别被天量库存骗了,2028年新房可能都不够卖? | 丞霖浊影深 | 前几天,高盛一份地产研报,在圈内炸了。 既不唱衰崩盘,也不画上涨大饼,它只干了一件实在事:下沉到城市,实打实清点存... | 27 | 2026-10-26T14:58:00Z | 河南 |
All 25 fields in one record
typearticlearticleId7700872920532320803urlhttps://www.toutiao.com/article/7700872920532320803/title高盛预测中国楼市:别被天量库存骗了,2028年新房可能都不够卖?text前几天,高盛一份地产研报,在圈内炸了。 既不唱衰崩盘,也不画上涨大饼,它只干了一件实在事:下沉到城市,实打实清点存...textAvailableimagesimageCount27publishedAt2026-10-26T14:58:00ZpublishLocation河南isOriginalreadCount4422likeCount57commentCount35shareCount36collectCount38impressionCount99172authorId2694234264069886authorName丞霖浊影深authorAvatarhttps://p3-sign.toutiaoimg.com/user-avatar/a6bac329d69cf6...authorDescriptionauthorVerifiedauthorVerifiedInfo鄢陵县丞霖文化传媒有限公司官方账号authorMediaId1763944398034958authorFollowerCount
Call the Toutiao API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing. These are the charge events and their prices:
| Event | Price (USD) | When it is charged |
|---|---|---|
run-start |
$0.00005 | Once per run, charged when the first request succeeds. It is not charged when the run fails from the start, or when your spending limit cannot cover it. |
result |
$0.00368 | For each record returned: an article, a video or a comment |
Worked examples:
- One article: $0.00005 + $0.00368 = $0.00373.
- 100 articles: $0.00005 + 100 x $0.00368 = $0.36805.
- One article with 100 comments: $0.00005 + 100 x $0.00368 = $0.36805.
- The first 20 comments of each of 10 articles: $0.00005 + 200 x $0.00368 = $0.73605.
You never pay for more than maxResults records, you are never charged for records that were not delivered, and the run stops by itself if your spending limit is reached. An ID that returns nothing (a deleted article or video, a post without comments) is not charged as a record.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Toutiao API questions
Do I need a Toutiao account or cookies?
No. The Actor reads public pages only, with no login.
Can I search Toutiao by keyword?
No. This Actor has no keyword search, trending list or channel feed. Give it IDs or links you already have, and it returns the records behind them.
Is it legal?
It collects only information that anyone can see on public Toutiao pages, and no private data such as phone numbers or messages. You are responsible for how you use the data and for following the laws that apply to you.
How fresh is the data?
Every run reads the live page, so counts and comments are current as of the run.
Why are some fields empty?
Not every post has every field. Images only exist on some articles, an author may have no bio, and a comment may have no IP location. Videos from the standard lookup carry no publish time.
How many comments can I get?
As many as the platform lists publicly, up to the `maxResults` you set (at most 5000 per run).