
Toutiao Trending Scraper
hipersoft/toutiao-scraper
Scrape the Toutiao (今日头条) news hot board: rank, title, hot value, label, category and link. China's biggest news-aggregator trending list.
Total users
2Monthly users
1Total runs
91Per topic scraped
$0.001Last rebuilt
Oct 26, 2026Overview
Scrape the Toutiao hot board — the trending news list of 今日头条, China's biggest news aggregator — into clean JSON, CSV or Excel. This Toutiao scraper extracts rank, title, hot value, label (new/hot), category, thumbnail and link for every trending news topic. Fast and reliable.
Perfect for China news monitoring, PR and brand tracking, trend discovery and media research.

What does Toutiao Scraper do?
The Toutiao Scraper collects the live trending news hot board from Toutiao and returns it as structured data. It extracts every topic on the board with its rank, heat value, labels and category, so you can monitor what is trending in Chinese news and build a time series of topics.
What data can you scrape from Toutiao?
| Category | Fields |
|---|---|
| 📊 Ranking | rank, hot value |
| 📰 Topic | title, label, is new, is hot, category |
| 🔍 Reference | query word, cluster id |
| 🖼️ Media & links | image, topic URL, source URL, collected date |
What you get

Each trending topic is returned as one clean record. Example output:
{
"rank": 1,
"title": "一组数据读懂我国能源转型新趋势",
"hotValue": 12704620,
"label": "new",
"isNew": true,
"isHot": false,
"category": "society",
"queryWord": "能源转型",
"clusterId": "7668250705069",
"image": "https://p3.toutiaoimg.com/...",
"url": "https://www.toutiao.com/trending/7668",
"sourceUrl": "https://www.toutiao.com/hot-event/hot-board/",
"collectedAt": "2026-07-30T12:00:00.000Z"
}
Output schema
| Field | Type | Description |
|---|---|---|
rank |
integer | Position of the topic on the hot board. |
title |
string | Trending news topic title. |
hotValue |
integer | Toutiao heat metric; higher means hotter. |
label |
string | Topic label, e.g. new or hot. |
isNew |
boolean | Whether the topic is flagged as new. |
isHot |
boolean | Whether the topic is flagged as hot. |
category |
string | Topic category, e.g. society. |
queryWord |
string | Search keyword associated with the topic. |
clusterId |
string | Internal cluster identifier for the topic. |
image |
string (URL) | Thumbnail image URL. |
url |
string (URL) | Direct link to the topic on Toutiao. |
sourceUrl |
string (URL) | Source page URL for the record. |
collectedAt |
string (ISO date) | Timestamp when the record was collected. |
Use cases
- China news monitoring — track what is trending across Chinese news in real time.
- PR and brand tracking — catch topics mentioning a brand, product or public figure.
- Trend discovery — spot rising stories early using rank and hot value.
- Media research — analyze categories and heat across time.
- Time-series building — schedule the actor to capture the board on an interval.
- Content planning — align editorial calendars with what audiences care about now.
How to scrape Toutiao data
- Add the Toutiao Scraper to your Apify account.
- Set the maximum number of trending topics to scrape.
- Click Run.
- Export the results as JSON, CSV, Excel or XML, or pull them via the Apify API.
- Optionally schedule the actor (e.g. every 15–30 minutes) to build a time series.
Input
{
"maxItems": 100
}
| Field | Type | Description |
|---|---|---|
maxItems |
integer | Maximum number of trending news topics to scrape. |
Tips
- The board is realtime — schedule the actor (e.g. every 15–30 min) to build a time series of China's trending news.
hotValueis Toutiao's heat metric; higher means hotter.
Need more Chinese content data?
FAQ
How many topics can I scrape?
As many as the board carries — set maxItems to cap the run.
Do I need any setup or a login? No setup and no login. Just add the actor and run.
How fresh is the data? The hot board is realtime, so each run reflects what is trending at that moment.
What export formats are supported? JSON, CSV, Excel and XML, plus programmatic access through the Apify API.
How does billing work? You pay only per item you get, so costs scale with the number of topics you scrape.
Is the data only public data? Yes — the scraper returns only publicly available trending-topic information.
Can I integrate this with other tools? The Toutiao Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. It works with Make, Zapier, Slack, Airbyte, GitHub, Google Drive and many more, plus the Apify API, JavaScript/Python clients and MCP. Or use webhooks to trigger an action whenever a run finishes.
Notes
Original clean-room implementation. Returns only public data; you are responsible for compliance with Toutiao's terms. Not affiliated with Toutiao or ByteDance.
Input
| Field | Type | Description |
|---|---|---|
maxItemsMax topics | integer | Maximum trending news topics to scrape. Default: 100 |
API
curl -X POST "https://api.apify.com/v2/acts/hipersoft~toutiao-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("hipersoft/toutiao-scraper").call(run_input={})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('hipersoft/toutiao-scraper').call({});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);Pricing
| Event | Price | Paid plans from |
|---|---|---|
| Topic scraped One trending news topic scraped. | $0.001 | $0.001 |
| API request One Toutiao API request. | $0.0008 | $0.0008 |
You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.
Related scrapers
Europe PMC Scraper
Bulk-scrape life-science and biomedical literature from Europe PMC (40M+ records: PubMed, PMC, preprints, patents): title, abstract, authors, journal, year, DOI, PMID/PMCID, citation count, MeSH terms, open-access flag and full-text/PDF links. Thousands per run. No setup.
325 runs · 5 users · $0.001 / article scrapedarXiv Papers Scraper
Search and extract arXiv papers: title, abstract, authors, categories, published/updated dates, DOI, journal reference, and direct PDF links. Filter by category and sort by newest, recently updated or relevance. Fetch by arXiv ID too. For research, lit reviews and AI/ML monitoring. No setup.
140 runs · 2 users · $0.0025 / paper scrapedLetterboxd Scraper
Scrape Letterboxd films with ratings, rating counts, genres, director, cast, runtime and synopsis. Feed it film pages, a user's films/watchlist/diary, any list URL, or browse pages. For film data, recommendations and research.
139 runs · 7 users · $0.0042 / film scrapedOpenLibrary Book Scraper
Search millions of books on OpenLibrary by keyword, author, subject or ISBN and get title, authors, publisher, year, subjects, ISBNs, edition count, ratings, page count and cover. Clean, no setup.
124 runs · 5 users · $0.002 / book scrapedSemantic Scholar Scraper
Bulk-scrape academic papers from Semantic Scholar's 200M+ corpus: title, abstract, AI TLDR summary, authors, venue, year, citation & influential-citation counts, fields of study, DOI/PubMed/arXiv IDs and open-access PDF links. Filter by year, field and citations. Thousands per run. No setup.
123 runs · 7 users · $0.001 / paper scrapedWikipedia Scraper
Search Wikipedia or look up exact articles and get the full plain-text content, summary, categories, image, Wikidata ID and monthly pageview trends. Any language. Great for research, RAG and AI datasets. No setup.
121 runs · 1 users · $0.001 / article scrapedSend the site and the fields. We build it and you get it first.