toutiao.com APItoutiao.com ↗
Access Toutiao's homepage feed, category feeds, article details, trending hot list, comments, and video content via a structured JSON API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/ec8d8006-f607-43ff-ae22-6c64882ca5a2/get_homepage_feed' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the main recommended article feed from the Toutiao homepage. Returns an array of article objects with metadata including title, abstract, comment count, and article/group IDs usable for detail and comment endpoints.
No input parameters required.
{
"type": "object",
"fields": {
"articles": "array of article objects with fields like Abstract, article_url, group_id, item_id, comment_count, digg_count, media_info, publish_time"
},
"sample": {
"data": {
"articles": [
{
"item_id": "7634676592689545743",
"Abstract": "五月神州，又一个礼赞劳动的节日如期到来。",
"group_id": "7634676592689545743",
"has_video": false,
"digg_count": 836,
"article_url": "https://content-static.cctvnews.cctv.com/snow-book/index.html?item_id=15876166303712142271",
"publish_time": 1777586679,
"comment_count": 444
}
]
},
"status": "success"
}
}About the toutiao.com API
The Toutiao API provides 7 endpoints covering China's leading news aggregation platform, returning structured article data from feeds, search, and detail pages. You can pull the homepage feed with get_homepage_feed, fetch category-specific articles using channel slugs like news_tech or news_entertainment, retrieve full HTML article content, and query the trending hot board — all in a single API surface.
Feeds and Article Data
The get_homepage_feed endpoint returns an array of article objects from Toutiao's main recommended feed, each carrying fields including Abstract, article_url, group_id, item_id, comment_count, digg_count, media_info, and publish timestamp. The get_category_feed endpoint accepts a required channel parameter — verified values include news_tech, news_entertainment, news_sports, news_finance, and video — and returns the same article object shape scoped to that channel.
Article Detail and Comments
get_article_detail takes an article_id (a numeric string obtainable from feed endpoints) and returns the full HTML content, title, source, abstract, itemId, and publishTime. Video articles return a distinct schema that includes video playback metadata. get_article_comments accepts the same article_id along with optional count and offset parameters for pagination, returning comment objects with id, text, user_name, digg_count, create_time, and publish_location.
Search and Trending
search_articles accepts a required keyword and an optional type parameter — news, video, or synthesis — and returns results with fields including title, abstract, source, url, item_id, publish_time, and comment_count. Chinese-language keywords yield the broadest result coverage across all search types. The get_hot_trending_list endpoint requires no inputs and returns ranked trending topic objects carrying Title, HotValue, Label, Url, ClusterId, InterestCategory, and QueryWord fields.
Video Feed
get_video_feed returns the same article object structure as category feeds but scoped to video content, with a has_video flag and large_image_list field on each article object. The channel field in the response is always video.
- Monitor the Toutiao trending hot list to track breaking news topics by
HotValueandTitlein real time. - Aggregate Chinese-language technology news by querying
get_category_feedwith thenews_techchannel. - Build a comment analytics dataset using
get_article_commentswithcountandoffsetto paginate through reader engagement on specific articles. - Track media source publication frequency by extracting the
sourceandpublishTimefields fromget_article_detailresponses. - Search for topic coverage across Toutiao using
search_articleswithtype=synthesisand Chinese-language keywords. - Identify trending video content by cross-referencing
get_video_feedarticledigg_countvalues against the hot board. - Pull article
comment_countanddigg_countfrom feed endpoints to rank engagement across categories.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Toutiao have an official developer API?+
What does `get_hot_trending_list` return and how is it ranked?+
HotValue field indicating relative rank, a Title, a QueryWord for triggering follow-on searches, an InterestCategory label, and a Url linking to the topic page. There are no input parameters — the list reflects Toutiao's current hot board at the time of the request.Does `search_articles` work with English keywords?+
video search type, which works best with Chinese-language terms. The news and synthesis types return more results with Chinese keywords as well, reflecting Toutiao's primary Chinese-language content corpus.Does the API expose author profile pages or follower data?+
Can I fetch multiple pages of comments for a single article?+
get_article_comments supports pagination via the offset integer parameter. Increment offset by the value of count on each successive request to walk through additional comment pages. The response includes a message field confirming request status, and each comment object carries a create_time for ordering.