top.baidu.com APItop.baidu.com ↗
Fetch real-time hot search rankings, novel, movie, and TV drama charts from Baidu Top. 8 endpoints, genre filtering, hot scores, and cloud trending words.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1c4f754a-689d-4bde-9ce0-8c483778c3f3/get_realtime_hot_search' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the real-time hot search rankings (热搜榜) from the Baidu Top board. Returns the current top trending search terms with scores and metadata.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of objects with rank, title, query, description, hot_score, hot_change, labels, image, url, raw_url",
"update_time": "string or null, Unix timestamp of last update"
},
"sample": {
"data": {
"items": [
{
"url": "https://www.baidu.com/s?wd=%E4%B8%AD%E7%BE%8E%E5%85%83%E9%A6%96%E7%A5%88%E5%B9%B4%E6%AE%BF%E5%B9%BF%E5%9C%BA%E5%90%88%E5%BD%B1&sa=fyb_news&rsv_dl=fyb_news",
"rank": 1,
"image": "https://fyb-1.cdn.bcebos.com/fyb/de6163834f53ca92c1273fff98ac9078.jpeg",
"query": "中美元首祈年殿广场合影",
"title": "中美元首祈年殿广场合影",
"labels": [],
"raw_url": "https://www.baidu.com/s?wd=%E4%B8%AD%E7%BE%8E%E5%85%83%E9%A6%96%E7%A5%88%E5%B9%B4%E6%AE%BF%E5%B9%BF%E5%9C%BA%E5%90%88%E5%BD%B1",
"hot_score": 7809196,
"hot_change": "same",
"description": ""
}
],
"update_time": null
},
"status": "success"
}
}About the top.baidu.com API
The Baidu Top API exposes 8 endpoints covering real-time hot search rankings, novel charts, movie rankings, and TV drama boards from top.baidu.com. Each response includes per-item fields like hot_score, hot_change, labels, and rank, plus tags_available for genre and region filtering. The get_realtime_hot_search endpoint returns the current trending search terms with scores and metadata, while get_homepage_summary delivers a cross-category overview including cloud trending words.
Trending Search and Rankings Coverage
The get_realtime_hot_search endpoint returns the current 热搜榜 (hot search board) as an array of ranked items. Each item carries rank, title, query, hot_score, hot_change, description, labels, image, and both url and raw_url fields. The update_time field is a Unix timestamp string indicating when the board was last refreshed, or null if unavailable. No input parameters are required — the endpoint always returns the live snapshot.
Content-Specific Boards with Tag Filtering
Three dedicated endpoints — get_novel_rankings, get_movie_rankings, and get_tv_drama_rankings — mirror the structure of the hot search board but scope results to their respective content types. All three return a tags_available array of tag group objects (each with typeName, text, content, and curIndex), which expose the available genre and region filters for that board. The get_board_by_tab endpoint generalises this: pass a tab parameter (realtime, novel, movie, or teleplay) and an optional tag string (e.g. 都市, 玄幻, 爱情, 喜剧) to retrieve any board with filtering applied in a single call. The get_novel_rankings_by_genre endpoint further specialises this for novels, accepting a genre string and returning filtered novel items alongside tags_available.
Homepage Summary and Cloud Trending Topics
The get_homepage_summary endpoint returns a cards array covering all category boards, each with a title, type, and nested items and optional top_items arrays. It also returns a cloud array of trending word objects, each containing word, hotScore, wordType, and url. This endpoint is suited for dashboards that need a cross-category snapshot in a single request.
URL Construction Utility
The get_search_results_for_keyword endpoint does not return search results. It accepts a keyword string and returns the corresponding Baidu search URL (search_url). This is useful for building links that redirect users to live Baidu search pages for any trending term surfaced by the other endpoints.
- Track daily shifts in Chinese public interest by monitoring
hot_scoreandhot_changefields fromget_realtime_hot_search. - Build a content recommendation dashboard that aggregates top novels, movies, and TV dramas using the three dedicated ranking endpoints.
- Filter novel rankings by genre (e.g. 玄幻 or 现代言情) using
get_novel_rankings_by_genreto identify trending titles in a specific category. - Populate a trending-topics widget using the
cloudarray fromget_homepage_summary, which exposesword,hotScore, andwordTypefor each cloud term. - Generate direct Baidu search deep-links for trending keywords using
get_search_results_for_keywordto route users to live news and discussions. - Monitor entertainment trends in the Chinese market by comparing
hot_scorevalues across movie and TV drama boards over time. - Discover available genre and region filters for any board tab without a separate metadata call by reading
tags_availablefrom any ranking endpoint response.
| 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 Baidu Top have an official developer API?+
What does `hot_change` represent in ranking responses?+
hot_change field appears on every ranked item across all board endpoints and indicates the directional movement of a term or title in the rankings — for example, whether it has risen, fallen, or is newly entered. The exact numeric or categorical value reflects what Baidu Top reports for that item at the time of the snapshot.Does the API support historical or time-series ranking data?+
Can the API filter movies by region (e.g. Chinese vs. foreign films)?+
get_movie_rankings endpoint returns a tags_available array that includes region-based tag groups alongside genre tags, exposing what filters Baidu Top supports. However, applying a specific region filter requires using get_board_by_tab with the tab set to movie and passing the relevant tag string. If the region tag you need is not listed in tags_available, it is not currently exposed. You can fork this API on Parse and revise it to surface additional tag-filtering combinations.