# Baidu Hot Search API > The live Baidu trending boards (百度热搜), read keyless from Baidu's public "top" board endpoint. Baidu is China's dominant search engine, and its hot-search board is the country's most-watched read on what people are searching for right now — the Chinese equivalent of Google Trends' real-time list, the pulse of the Chinese internet. The realtime endpoint returns the main national hot-search board ranked by heat: each entry with its rank, the trending word, Baidu's heat score (its own searches-driven ranking metric), whether it is rising, falling or steady, an editorial tag and a one-line description. The category endpoint returns one of Baidu's themed boards — film, TV drama, novels, games, cars or finance — the same way. This is the Baidu trending cut — distinct from the Western trends feeds (Google, Wikipedia, Reddit) and from the platform feeds in the catalogue: it is what China is searching for. Heat scores are Baidu's own ranking metric, not a raw search count; words and descriptions are in Chinese as Baidu publishes them. Counts are the real, live numbers Baidu shows; a short cache fronts the upstream. Keyless. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/baiduhot-api/..." ``` ## Pricing - **Free** (Free) — 650 calls/Mo, 2 req/s - **Starter** ($28/Mo) — 68,000 calls/Mo, 6 req/s - **Pro** ($73/Mo) — 470,000 calls/Mo, 16 req/s - **Scale** ($204/Mo) — 2,850,000 calls/Mo, 40 req/s ## Endpoints ### Realtime #### `GET /v1/realtime` — Baidu realtime national hot-search board, ranked by heat **Parameters:** - `limit` (query, optional, string) — Max items (1-50) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/baiduhot-api/v1/realtime?limit=50" ``` **Response:** ```json { "data": { "note": "Baidu's realtime national hot-search board (百度热搜) — what China is searching for right now, ranked by heat. Each entry has its rank, the trending word, Baidu's heat_score (its own ranking metric, not a raw search count), hot_change (rising/falling/steady), an editorial hot_tag and a one-line description. Items flagged is_top are editorially pinned above the ranked list. Words and descriptions are Chinese as Baidu publishes them. Pass limit (1-50). Live, cached ~5m.", "board": "realtime", "count": 50, "source": "Baidu public top-board endpoint (top.baidu.com/api/board, realtime), keyless", "trending": [ { "rank": null, "word": "总书记朝鲜行的“重要里程碑意义”", "is_top": true, "hot_tag": "0", "hot_score": 7904345, "hot_change": "same", "search_url": "https://www.baidu.com/s?wd=%E6%80%BB%E4%B9%A6%E8%AE%B0%E6%9C%9D%E9%B2%9C%E8%A1%8C%E7%9A%84%E2%80%9C%E9%87%8D%E8%A6%81%E9%87%8C%E7%A8%8B%E7%A2%91%E6%84%8F%E4%B9%89%E2%80%9D&sa=fyb_news&rsv_dl=fyb_news", "description": "6月8日至9日，习近平总书记对朝鲜进行国事访问，在两国关系发展史上具有重要里程碑意义。一支视频，从细节感悟中朝两国弘扬优良传统，密切团结协作。" }, { "rank": 1, "word": " …(truncated, see openapi.json for full schema) ``` ### Category #### `GET /v1/category` — A themed Baidu trending board by tab **Parameters:** - `tab` (query, required, string) — Board: movie, teleplay, novel, game, car or finance Example: `movie` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/baiduhot-api/v1/category?tab=movie" ``` **Response:** ```json { "data": { "note": "One of Baidu's themed trending boards (movie, teleplay, novel, game, car, finance), ranked by heat the same way as the realtime board — each entry with its rank, word, heat_score, hot_change, hot_tag and description. Words and descriptions are Chinese as Baidu publishes them. Live, cached ~5m.", "board": "movie", "count": 10, "source": "Baidu public top-board endpoint (top.baidu.com/api/board), keyless", "trending": [ { "rank": 1, "word": "寒战1994", "is_top": false, "hot_tag": null, "hot_score": 96438, "hot_change": null, "search_url": "https://www.baidu.com/s?wd=%E5%AF%92%E6%88%981994+%E7%94%B5%E5%BD%B1&sa=fyb_movie_all_all&rsv_dl=fyb_movie_all_all", "description": "1994年，香港回归前夕，政治部即将解散。一宗富商绑架案，让热血正义的李文彬（刘俊谦 饰）与冷血野心家蔡元祺（吴彦祖 饰），在警界掀起一场暗潮涌动的权力较量。" }, { "rank": 2, "word": "10间敢死队", "is_top": false, "hot_tag": null, "hot_score": 89672, "hot_change": null, "search_url": "https://www.baidu.com/s?wd=10%E9%97%B4%E6%95%A2%E6%AD%BB%E9%98%9F+%E7%94%B5%E5%BD%B1&sa=fyb_movie_all_all&rsv_dl=fyb_mov …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/baiduhot-api/v1/meta" ``` **Response:** ```json { "data": { "note": "realtime takes limit (1-50). category takes tab (one of: movie, teleplay, novel, game, car, finance). meta takes no parameters. heat_score is Baidu's own ranking metric, not a raw search count; words/descriptions are Chinese as published. A short ~5-minute cache fronts Baidu.", "sample": { "top_word": "这届世界杯有点太政治了", "hot_score": 7809423 }, "source": "Baidu public top-board endpoint (top.baidu.com/api/board), keyless, live", "service": "baiduhot-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/category": "A themed board by tab (tab=movie).", "GET /v1/realtime": "Baidu realtime national hot-search board, ranked by heat (limit)." }, "categories": [ "movie", "teleplay", "novel", "game", "car", "finance" ], "description": "The live Baidu trending boards (百度热搜), keyless. Baidu is China's dominant search engine and its hot-search board is the country's most-watched read on what people are searching for right now — China's real-time search trending. The realtime endpoint returns the main national hot-search board ranked by heat (word, heat score, rank, rising/falling, tag, description); the category endpoint returns a themed board (movie, teleplay, novel, game, car, finance). The Baidu trending cut — di …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/baiduhot-api OpenAPI spec: https://www.oanor.com/api/baiduhot-api/openapi.json