# China Hot Search in English — Weibo, Zhihu, Baidu & Douyin (`china.unofficial/china-hot-search-english`) Actor

Weibo hot search (微博热搜), Zhihu, Baidu, Douyin, Toutiao and Bilibili hot lists plus Chinese news, with English headlines, rank and heat. Optional Deletion Watch flags hot topics that vanish while trending.

- **URL**: https://apify.com/china.unofficial/china-hot-search-english.md
- **Developed by:** [Ownly China Media Feed](https://apify.com/china.unofficial) (community)
- **Categories:** AI, News, Social media
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $8.00 / 1,000 feed rows

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## China Hot Search in English: Weibo, Zhihu, Baidu & Douyin

**Weibo hot search (微博热搜), Zhihu (知乎), Baidu (百度), Douyin (抖音), Toutiao (今日头条) and Bilibili (哔哩哔哩) hot lists, plus Chinese news, in one dataset with English headlines.**

Every row has the original Chinese, a machine English headline where one is available, the rank, the heat score and a link. You can also turn on Deletion Watch, which flags hot topics that vanish while they are still trending.

### Sample row

```json
{
  "kind": "hot",
  "source_id": "weibo",
  "source_name": "Weibo Hot Search 微博热搜",
  "headline_en": "\"See You Later\"—The whole team has achieved great results!",
  "headline_original": "后会有期全员拿到大结果了",
  "rank": 1,
  "heat": 1163605,
  "peak_rank": 1,
  "url": "https://s.weibo.com/weibo?q=%23后会有期全员拿到大结果了%23",
  "translation_status": "ok",
  "translation_model": "offline-argos-zh-en"
}
```

### Who buys this

| You are | You use it for |
|---|---|
| China analyst, think tank, risk desk | A daily English read of what China's platforms are trending on, next to state media and overseas Chinese media coverage of the same story |
| Brand, marketing or consumer-insights team | Spotting trends on Weibo, Douyin and Zhihu early, and tracking when your brand or category is on a hot list |
| Journalist or newsletter writer | A morning list of China trending topics in English, with links back to the original |
| AI / LLM builder | A clean, labeled feed of Chinese trending topics and headlines for RAG, agents or training evaluation |
| Researcher | Hot-list rank and heat over time, plus topics that left a list while still hot |

### What you get

- **Hot lists.** Weibo hot search, Baidu hot search, Zhihu hot list, Toutiao hot board, Bilibili hot search and Douyin hot list, each row with `rank`, `heat` and `peak_rank`. Kuaishou is optional.
- **Chinese news.** News rows from many outlets, each with a `source_type` label: State media, Party-gov, Commercial platform, Overseas Chinese media (海外华文媒体), Critical voices (批评声音) or Censorship tracker. The label describes the outlet, not whether a story is true. Rows about the same story share a `topic_id`.
- **English.** Most Chinese headlines come with a machine English translation. Each row shows `translation_status` (`ok`, `translation_pending` or `failed`), and `headline_original` always keeps the Chinese. Machine translation can get names and slang wrong, so check the original before you quote it.
- **Deletion Watch (optional, paid add-on).** Topics that drop off the Weibo, Baidu, Zhihu, Toutiao or Bilibili hot lists while still hot are rechecked and flagged **Likely censored**, with the evidence. A topic is marked **Censored** only when there is a dead link, a platform removal notice or a close match in a censorship tracker. If a topic comes back it is marked **Returned**. Platforms also curate their lists for commercial reasons, so treat a flag as a lead and read the evidence.

### Settings

| Setting | What it does |
|---|---|
| `hotLists` | Which hot lists to include |
| `sourceTypes` | Which kinds of news outlet to include; leave it empty for hot lists only |
| `newsSources` | Pick specific outlets, or `all` |
| `keywords` | Keep only rows that match any of these words (free) |
| `maxItems` | Max billed rows per run (prefilled at 50) |
| `maxHotRank` | Keep hot-list rows down to this rank |
| `emitOnlyNew` | Skip rows you already received (on by default) |
| `deletionWatch` | Turn on deletion flags (paid add-on) |

### Quick start

**Weibo hot search in English, top 30:**

```json
{"hotLists": ["weibo"], "sourceTypes": [], "maxHotRank": 30, "maxItems": 30, "emitOnlyNew": true}
```

**China trending in English, all hot lists plus news:**

```json
{"hotLists": ["weibo", "zhihu", "baidu", "douyin", "toutiao", "bilibili"], "maxHotRank": 20, "maxItems": 100}
```

**Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("china.unofficial/china-hot-search-english").call(
    run_input={"hotLists": ["weibo"], "sourceTypes": [], "maxHotRank": 30, "maxItems": 30})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["rank"], row["headline_en"], "|", row["headline_original"])
```

**curl:**

```bash
curl -X POST "https://api.apify.com/v2/acts/china.unofficial~china-hot-search-english/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"hotLists": ["weibo"], "sourceTypes": [], "maxHotRank": 30, "maxItems": 30}'
```

To run it every day, click **Save as a new task**, then add the task to a schedule in **Schedules**. Leave **Only rows I haven't received yet** on so you are not billed twice for the same row.

### Run status and useful fields

- When some sources are down, the run's status message says: "Some sources, story matching and English translations are temporarily unavailable in this run." You still get the rows that were collected.
- `maxItems` caps billed rows. The Console pre-fills 50. Left empty, the cap is 200.
- `fetch` shows how a row is refreshed: `scheduled` (every run, the default) or `hourly`.
- `via` names the third-party copy a hot-list row came from, or is `null`.
- `translation_status` is `ok`, `translation_pending` or `failed`. A pending row is labeled "Translation pending; original shown" and carries the Chinese headline.

### Pricing

- **$8 per 1,000 rows (rising to $15 in December)** ($0.008 per row). There is no start fee.
- A 50-row trial costs $0.40, and the top 30 of Weibo costs $0.24.
- **Deletion Watch add-on:** $0.05 for each Likely censored or Censored flag. Returned rows and plain rows carry no add-on.
- `keywords` and `emitOnlyNew` are free.
- A run can return fewer rows than `maxItems`. You pay only for rows delivered.

### FAQ

**How do I get Weibo hot search (微博热搜) in English?**
Set `hotLists` to `["weibo"]`, set `sourceTypes` to `[]`, and set `maxHotRank`, for example to 30. Each row has the Chinese topic, an English headline, the rank, the heat and a link.

**Is there a Zhihu, Baidu or Douyin hot list in English?**
Yes. Add `zhihu`, `baidu` or `douyin` to `hotLists`.

**What is trending in China today?**
Run the "China trending in English" setup above and sort by `rank`.

**Is every row in English?**
No. Most Chinese headlines are machine-translated. A row with no translation yet shows `translation_status: translation_pending` and the Chinese headline.

**Do I need a Weibo, Zhihu or Baidu account?**
No. Everything comes from public, logged-out pages.

**Does a source label mean a story is true or false?**
No. `source_type` describes the outlet, not the story.

**Why "Likely censored" rather than "Censored"?**
Topics leave hot lists for many reasons. A flag becomes Censored only when there is a dead link, a platform removal notice or a close tracker match.

### Leave a review

If this Actor helps your work, a short review on the Store page helps other people find it. If you see a problem, please report it in the Issues tab.

# Changelog

This Actor's version history is a separate document: https://apify.com/china.unofficial/china-hot-search-english/changelog.md

# Actor input Schema

## `hotLists` (type: `array`):

Public trending lists, fetched logged-out. Leave a list out and it is not fetched or billed. Pick only Weibo for a Weibo-only feed.

## `sourceTypes` (type: `array`):

Which news rows to include, by the type of outlet that published them. The label describes the outlet, not whether a story is true. Choose none for hot lists only.

## `newsSources` (type: `array`):

"all" (default) = every approved outlet that can be read logged-out. Or list outlet ids, for example xinhua, mfa, bbc.

## `keywords` (type: `array`):

Keep only rows whose title, summary or source contains one of these words (Chinese or English, case-insensitive). Empty keeps all.

## `maxItems` (type: `integer`):

Cap on the total number of billed rows this run. The Console pre-fills 50. Left empty, the cap is 200. A run capped at 200 rows or fewer finishes in about 4 minutes with the rows it collected by then.

## `maxHotRank` (type: `integer`):

Hot-list topics ranked below this are left out. 50 keeps the whole board.

## `emitOnlyNew` (type: `boolean`):

On (default): a scheduled run returns and bills only rows that are new since your last run. Off: every run returns a full snapshot.

## `deletionWatch` (type: `boolean`):

Off by default. On: topics that drop off the Weibo, Baidu, Zhihu, Toutiao or Bilibili hot lists while still hot are rechecked and flagged Likely censored, with the evidence for each flag. Each flag is billed as a deletion-watch-row event on top of the row price; Returned rows have no add-on charge. See the Pricing tab.

## Actor input object example

```json
{
  "hotLists": [
    "weibo",
    "baidu",
    "zhihu",
    "toutiao",
    "bilibili",
    "douyin"
  ],
  "sourceTypes": [
    "State media",
    "Party-gov",
    "Commercial platform",
    "Overseas Chinese media",
    "Critical voices",
    "Censorship tracker"
  ],
  "newsSources": [
    "all"
  ],
  "keywords": [],
  "maxItems": 50,
  "maxHotRank": 50,
  "emitOnlyNew": true,
  "deletionWatch": false
}
```

# Actor output Schema

## `results` (type: `string`):

Every row from this run: news items, hot-list items and deletion flags.

## `censored` (type: `string`):

Deletion-watch flags only, each with its status (Censored, Likely censored or Returned) and the evidence behind it.

## `feedEn` (type: `string`):

News rows with English headlines and short summaries, machine-translated. Rows not yet translated are marked translation_pending.

## `feedZh` (type: `string`):

News rows in the original Chinese, each labeled by outlet type.

## `topics` (type: `string`):

Story clusters: the same story grouped across state, commercial, overseas Chinese media and Critical voices outlets.

## `sourceStatus` (type: `string`):

Every source with its status for this run, the number of items it returned, and the error for any that failed.

## `top15` (type: `string`):

The run's top 15 stories as an English HTML report, with original-language headlines and quotes. A Markdown copy is also saved.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "hotLists": [
        "weibo",
        "baidu",
        "zhihu",
        "toutiao",
        "bilibili",
        "douyin"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("china.unofficial/china-hot-search-english").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "hotLists": [
        "weibo",
        "baidu",
        "zhihu",
        "toutiao",
        "bilibili",
        "douyin",
    ],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("china.unofficial/china-hot-search-english").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "hotLists": [
    "weibo",
    "baidu",
    "zhihu",
    "toutiao",
    "bilibili",
    "douyin"
  ],
  "maxItems": 50
}' |
apify call china.unofficial/china-hot-search-english --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,china.unofficial/china-hot-search-english"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/CeTIPfpcWcDrEhrPV/builds/ebtkbgvheMyvvX5cB/openapi.json
