Baidu API & Scraper: parameters and responses
This is the reference for the 6 Baidu endpoints under /baidu/v1 (search, news, images, videos, suggest and resolve_link) and their 14 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.
The Baidu Search API returns Baidu (百度) results as JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search gives the ranked web results with the real destination URL, snippet, source and date, plus ads with the advertiser's landing page, related searches, top stories, shopping cards, the Baike knowledge panel and Baidu Hot Search. news, images, videos and suggest cover Baidu News, Baidu Images, Baidu Video and autocomplete. It is built for China market research, SEO rank tracking on Baidu and AI pipelines that need a Chinese search source. One ReefAPI key, no Baidu account, no China proxy.
What each action returns
Measured on 2026-11-06 with live calls. Every action returns the standard envelope; rows below are inside data.
| Action | Rows | Filters and paging |
|---|---|---|
| search | organic_results[], ads[], related_searches[], top_stories[], shopping_results[], knowledge_graph, ai_overview, hot_searches[], pagination | num 10-50, page 1-76 or offset, time_period or date_from/date_to, site, file_type, scope (title or url), resolve_links |
| news | news_results[] with url, source, snippet, date, thumbnail; total_results | sort relevance or date, page (10 per page) |
| images | image_results[] with original, thumbnail, width, height, format, source_page; total_results | page (30 per page) |
| videos | video_results[] with the real video page URL, duration, platform name, date, thumbnail | page (about 10 per page) |
| suggest | suggestions[], Baidu's autocomplete in order | — |
| resolve_link | url: where a baidu.com/link?url=… redirect points | ad click links are refused |
A query Baidu marks as having no results returns NOT_FOUND, within a couple of seconds and without retrying; on images this also covers a page past the last one Baidu serves. ai_overview is Baidu's AI answer as plain text per section, with its cited sources listed once. A layout change on Baidu's side returns SCHEMA_DRIFT rather than an empty success.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/baidu/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"q": "笔记本电脑"
}
}{
"ok": true,
"meta": {
"api": "baidu",
"endpoint": "search",
"mode": "live",
"latency_ms": 2215.8,
"record_count": 6,
"bytes": 1563297,
"cache_hit": false,
"upstream_requests": 2,
"organic_count": 6,
"ads_count": 3,
"with_real_url": 6,
"charged_credits": 3,
"version": "0.1.1",
"request_id": "362e14c79c814eb6",
"queue_ms": 1,
"fetched_at": "2026-11-06T16:39:37.716Z"
},
"data": {
"search_parameters": {
"engine": "baidu",
"q": "笔记本电脑",
"query_sent": "笔记本电脑",
"page": 1,
"num": 10,
"offset": 0,
"time_filter": null,
"site": null,
"file_type": null,
"scope": "all"
},
"organic_results": [
{
"position": 1,
"type": "sg_kg_entity_san",
"title": "笔记本电脑(电脑的一种类型) - 百度百科",
"url": "https://baike.baidu.com/item/%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91/213561",
"link": "http://www.baidu.com/link?url=socm-CjascsDO7JdbUctvMPRPWWT7Lz7iSOuwSNeZuJmSqhYXytwmm-sjx7Cm3JeW9ldJJja8GhV69Q-NAXyHCYth22EmRf8qzyUw6kOWjOK4Uo17aYIN40UYMUNsXUb",
"domain": "baike.baidu.com",
"snippet": "电脑的一种类型",
"source": null,
"date": null,
"date_text": null,
"baidu_property": true
},
{
"position": 6,
"type": "tieba_general",
"title": "笔记本电脑吧 - 百度贴吧",
"url": "https://tieba.baidu.com/f?kw=%B1%CA%BC%C7%B1%BE&fr=ala0&loc=rec&tids=10447935142,11141428933,11140968509",
"link": "http://www.baidu.com/link?url=e_t9t1aX1eGzU95UCXshJTFxjCzZIQBfqqRbtZmM2JYgajmdmxr9X3ZyOSUMBUFc2pJDfn4Mh8Yyht-X38LmPXMNWwCcsctNp-Da0WV3DduUJNKVxEzNUIixxCIspQV1qJSxpbGnUf5BiTgKEfEtHq",
"domain": "tieba.baidu.com",
"snippet": "交流买本心得，帮助电脑小白。关注用户：522万人累计发贴：9037万购本指南笔吧评测室新手必读本本知识外设与改造【小白必读】2026年度 笔吧科普/祛魅/购机指南...精回复：489点击：34万 各位大佬我笔记本遇到一个问题来请教一下回复：13点击：46 买了二手笔记本需要注意啥回复：16点击：147 tieba.baidu.com/",
"source": null,
"date": null,
"date_text": null,
"baidu_property": true
},
{
"position": 7,
"type": "bk_polysemy",
"title": "联想笔记本电脑 - 百度百科",
"url": "https://baike.baidu.com/item/联想笔记本电脑/1618792",
"link": "http://www.baidu.com/link?url=RPaBFpE-qJvT-ctS3AvZsvn0BdnFYJIeCryHhzfL2RabTFczf4Eg38pf_BJyrEcC3aRvKMbBFK0u9YRJiaYhYalGJ9_Y3IAvXPZX8E3TZ7TPgIVps-USPG8QmUgDcWI3pWvQogPhIM8yHuOyBgeUNIANGtHDIMpOdXOh1Gf7P5a",
"domain": "baike.baidu.com",
"snippet": "联想笔记本电脑是联想集团生产的便携式计算机产品，产品线涵盖商用与消费级领域，配备指纹识别、人脸识别、TPM芯片等安全技术，支持一键恢复和APS硬盘保护系统。2004年，联想收购IBM个人电脑业务，获得ThinkPad系列所有权，并通过全球销售网络覆盖市场。2020... 产品发展 产品应用 系列产品 商用笔记本 特色技术 百度百科",
"source": null,
"date": null,
"date_text": null,
"baidu_property": true
}
],
"ads": [
{
"position": 1,
"placement": "top",
"title": "笔记本电脑-京东自营旗舰店-正品保障",
"link": "https://www.baidu.com/baidu.php?url=000000j0xnZgmfstWuLXf_hlDnHQqKKCAH0EVtBGcUK335yoy9mkGTEzsFHIyuzS8e5CvkLsIYva69ZwlRr3-7gNV-mDcxcdEz3tsx1AOsp7X8v8ykbQFYOsLGZEtzXFqufd_mNWoEvfzKvCd1cqLjoOjn3kayXTnV_zD0D3gVutWaGeFReoxMZDANDLzxC2xdUc7L3ssf84GFth5g3FCDjBluc4.Db_NR2Ar5Od669991t7jzzLc68WkswfqYq7K9MqOOgujSOODlxdlPSWSwSrevxz59LuUt-MYf45S2JZHSNL4_-aBMO6gxwjGO5EOvV5dexSKbLqE4EY5PWowIJmLxVEOdOYxLOO0M4wOe5ZZ-JqElOdlOklxuqZSEqjNYSVLK8tO3-aS5xS9xSOP3tZtWOspqM4YLOgQCSqMs8OfqxdOwOVgxJOlO9zl53WEkOvI54xUxO3P5tHtOSdfdOz5dOtjlOMl2rOw4SxzoLT5_JICLT5dEOBxtgO7NEOdOwOcxu-OUhSWtLO6ONBLllELS8-QA1u3eS5Hubllmyn-xZI8LIM",
"landing_url": "https://ccc-wt.jd.com/dsp/nc?ext=aHR0cHM6Ly9yZS5qZC5jb20vc2VhcmNoP2tleXdvcmQ9JmFkX29kPTE=&log=5WiROHKeDsU3pjhALLfS6qvRTg6Bdw5EMtbs9TbHr7wZKf8QebFjyI0CoTBLvJd+RCjyMoSUmNAbKmMQJtfZLXFQxl9yEED15zqhoy5zFbMVVh9RvZi0jWrvPK+n9fhH&me=88793602&mc=2135554305&mai=14467350747&ma=153446406675&hk=1559049201063&cid=nHRkP101P1bvn1bLPWR3PHDznH9xnWcdg17xnH0sg1wxnHR1PjfvPj0vPWTd&kw_enc_utf8=%E8%81%94%E6%83%B3%E6%89%8B%E6%8F%90%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91&wts=1&ssv=hg_1",
"domain": "ccc-wt.jd.com",
"description": "联想手提笔记本电脑-精选好物,惠聚京东,超值折扣,[京东官网]就等你来!京东品类全,折扣狠,送货更快,享品质购物逛京东!4分钟前有人咨询 点击咨询双11大促京东 2026-11"
},
{
"position": 2,
"placement": "middle",
"title": "笔记本电脑三防-全国总代理-原厂正品-批发价",
"link": "https://www.baidu.com/baidu.php?url=000000j0xnZgmfstWijeqi4ttcJ4AmD1jJ4Nwcmbhc10Ge55DEQk-YkX9MUlUK9TI5Ub0YJgmlaMtvmJOfVuE3LTFlhzcpv41bKM1nlVpRg5Iv8pY5dfUsm5LSlPgFD2iUu9ilPx29R33NJterUZtcKlo8q3ltm0JxpHc1T3jWRoaPfrFaswdilQCdDcVmkLVicNsuzs1fnzhLAIpJvs32q5tP_3.7b_NR2Ar5Od66EzgSNerQ0BK-qjgKZLqWAZ1tT5VSZjEen5M_sSL1sSVhZ1lTrO3T5VSZj4SrZxvmxgI9tqhZuvmIqXZ1en5o_sePSZ1L3IS1jl4r88uv-BPQnYPgggBmlpqSHuvuPveoZfYRyQS_XFBEIgugkero5QvGYTjGo_H7IX1klXMWb3delS1J1z3cMYnH7XH_olISOW8LI5NM-kYym_H7IXOI8lxZG3vIUe8glnHDgeOSEVOPgugSp8OlcJeOdOhOUOdtx1xEOQ9BOxLqDgeSElcEzYrLNgtC3EA9OvPNxz3x1uIPYvy2Etvg4I_dB-muCyr1GLqrwf.U1Y",
"landing_url": "https://b2b.baidu.com/aitf/s?q=%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91%E4%B8%89%E9%98%B2&from=search&fid=619284255&styl=b&sid=1510134&a_keywordid=1187663231914&a_unitid=12416993556&a_planid=1195567630&bd_vid=nHRkP101P1bvn1bLPWR3PHDznH9xnHfvnNtkg1Dsn7tYg1DzPjmdrjn1PjDkr0",
"domain": "b2b.baidu.com",
"description": "55分钟前有人拨打电话百度爱采购为你优选海量笔记本电脑热销货源,支持在线选购,实时询价.批发选购,上百度爱采购笔记本电脑专题页.百度爱采购 2026-11"
},
{
"position": 3,
"placement": "middle",
"title": "小新笔记本好吗-买东西上淘宝!海量商品集结,轻松畅购!",
"link": "https://www.baidu.com/baidu.php?url=000000j0xnZgmfstWmyMTqdO62gmRDPTvUYhUYl5ivrBUuIHnIPF24wm4R62ACEFoxiPCpwcP70F6vB48dEW9pRW67n39u_oUukR8K5L6lykIBy94QpWs7dXq7OiQ2VEoFGhmTtkP2rtB5kSVjm96NhGvspc9nK4nr9sGAL3AeCHJJJAaj4C5pBLFEBfm_ex24uFFUqyq_MiYsy2Sk3lmgS3EmcW.7Y_NR2Ar5Od66hHTSunPjzWxGEutJjQovgc6h8es_mc8E0k6BXl2PrMov_X5ug3eVIxAZke2qLWIol3vPrM-zI5HkzuPv1-3eorzEFb4XrHIkvX5HblL_UnEexMyOQSOEOZQlOWSra1SWsOjdWmllv2J7jZZ93SLjbS8ZFqT77h2ezCn8EuTWjbS_pIrZFqp7tpyuCp_5Zl1Fd3tyZWtVrM-zI5HkzuPv1-3eorzEFb4XrHIkvX5Hbs4rMVHC3ZHgmX5zs4PLM8s4PLou9zUVMds4PLMY3ThexY3Thed_s4PLM33ThevOj9zUVOu9zUE5u9zUEU43Thed_s4PLMY3Th",
"landing_url": "https://redirect.simba.taobao.com/rd?c=un&w=unionsem&k=74175f13c74157df&p=mm_26632258_3504122_32538762&b=8jWE1ijH9SjBSSu0OzC&s=&f=https%3A%2F%2Fuland.taobao.com%2Fsem%2Ftbsearch%3Frefpid%3Dmm_26632258_3504122_32538762%26keyword%3D%25E5%25B0%258F%25E6%2596%25B0%25E7%25AC%2594%25E8%25AE%25B0%25E6%259C%25AC%25E5%25A5%25BD%25E5%2590%2597%26bd_vid%3D{bd_vid}",
"domain": "redirect.simba.taobao.com",
"description": "小新笔记本好吗-淘宝热卖好物,品类众多,轻松下单!省心又省钱,还等什么?速抢!优选好物,尽在淘宝,淘你满意!五金配件去看看五金配件官方正品女装热卖去看看女装热卖在线选购住宅家具去看看住宅家具现货热销基础建材去看看基础建材实时询价 查看更多相关信息双11大促淘宝热卖 2026-11"
}
],
"related_searches": [
{
"query": "笔记本电脑哪个牌子好",
"link": "https://www.baidu.com/s?wd=%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91%E5%93%AA%E4%B8%AA%E7%89%8C%E5%AD%90%E5%A5%BD&tn=baidu&rsf=100632008&rsp=0&f=1&rs_src=0&rsv_pq=d28803e8000fdc52&rsv_t=d2c2l%2FHenLIT6uGkxTOew%2FCXpQZxFZl%2BabSBmJLWIHn%2FIUnkIO%2BsinGRN0U&rsv_dl=brs_28338_1"
},
{
"query": "笔记本电脑十大排名",
"link": "https://www.baidu.com/s?wd=%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91%E5%8D%81%E5%A4%A7%E6%8E%92%E5%90%8D&tn=baidu&rsf=100632008&rsp=1&f=1&rs_src=0&rsv_pq=d28803e8000fdc52&rsv_t=d2c2l%2FHenLIT6uGkxTOew%2FCXpQZxFZl%2BabSBmJLWIHn%2FIUnkIO%2BsinGRN0U&rsv_dl=brs_28338_2"
},
{
"query": "笔记本电脑报价",
"link": "https://www.baidu.com/s?wd=%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91%E6%8A%A5%E4%BB%B7&tn=baidu&rsf=100632008&rsp=2&f=1&rs_src=0&rsv_pq=d28803e8000fdc52&rsv_t=d2c2l%2FHenLIT6uGkxTOew%2FCXpQZxFZl%2BabSBmJLWIHn%2FIUnkIO%2BsinGRN0U&rsv_dl=brs_28338_3"
}
],
"top_stories": [
{
"title": "笔记本电脑什么品牌质量好,深入分析热门品牌与推荐",
"url": "https://baijiahao.baidu.com/s?id=1881111909236434989&wfr=spider&for=pc",
"domain": "baijiahao.baidu.com",
"link": "http://www.baidu.com/link?url=n9VM0E59t6Ztw27o2QHAaAMa0ZUdhe0LP4-XOujsvf36eRvkPWyiYbzTTfAxbXRM6VUBhvYLvsD4mZpNsVEjlGrqJAtdLfMb0Lxkv8b63Zm",
"source": "鉴好货",
"date_text": "昨天20:29",
"date": "2026-11-06",
"snippet": "选择笔记本电脑时，品牌往往成为决策的重要因素。如今市面上的品牌众多，各有特色，在笔记本电脑什么品牌质量好这一问题上，不同用户面临着不同的选择困扰。华硕以其高性价比和强大的创新设计在游戏及创意领域脱颖而出，而联想则凭借其耐用性和出色的人机工程学设计赢得了商用用户的青睐。机械革命专注于电竞市场，以卓越的性能和个性化设计获得年轻人的认",
"thumbnail": "https://t7.baidu.com/it/u=3957914190,2236718679&fm=3035&app=3035&size=r2,1&q=75&n=0&g=3n&f=JPEG&fmt=auto&maxorilen2heic=2000000?s=D70542AE895213EF2DD8051F03005081"
},
{
"title": "集邦预估 2026Q4 全球笔记本电脑面板需求环比下降超 20%",
"url": "http://baijiahao.baidu.com/s?id=1881074235319963699&wfr=spider&for=pc",
"domain": "baijiahao.baidu.com",
"link": "http://www.baidu.com/link?url=aFE9XvlfotK5vlCrjr-wlNft1c2fYOm3zDRz_1KSEm673yU0jy4QEaoZAfL_c-nXi0sAbXwMKAGyWMttWd3M7ZjK68W85basGEQ1XIj6gJu",
"source": "IT之家",
"date_text": "昨天10:29",
"date": "2026-11-06",
"snippet": "集邦预估 2026Q4 全球笔记本电脑面板需求环比下降超 20% IT之家消息，市场研究机构集邦咨询（TrendForce）今天（11 月 6 日）发布最新面板价格洞察报告，指出进入 11 月后，电视、显示器与笔记本电脑三类面板价格预计全线持平，短期内缺乏明显上涨动力。在电视面板方面，主要电视品牌第四季度采购量预计环比减少约 5%。",
"thumbnail": "https://t9.baidu.com/it/u=2318851648,983419902&fm=3035&app=3035&size=r2,1&q=75&n=0&g=3n&f=JPEG&fmt=auto&maxorilen2heic=2000000?s=A11270963E2E430BDC361DD30300C0A8"
},
{
"title": "2026年最建议买的笔记本电脑品牌,轻薄便携与高性能完美结合",
"url": "http://baijiahao.baidu.com/s?id=1881106597029429270&wfr=spider&for=pc",
"domain": "baijiahao.baidu.com",
"link": "http://www.baidu.com/link?url=aFE9XvlfotK5vlCrjr-wlNft1c2fYOm3zDRz_1KSEm6doFBo0sxTi5fShFED1mrmqheR-GMTuqp1AGoEu7O-fTaxUvWOGG7-hHVwLPgq_ta",
"source": "易点测评",
"date_text": "昨天19:04",
"date": "2026-11-06",
"snippet": "选择笔记本电脑时，面临琳琅满目的选项往往让人感到困惑，尤其是在不同品牌、型号和配置不断更新换代的当下，如何找到最合适自己的产品变得尤为重要。2026年最建议买的笔记本电脑品牌，不仅在技术上具有先进性，更具备极佳的口碑与用户体验。在评测过程中，我们将深入探讨各个品牌的特点以及它们的优势，为消费者提供全面的...",
"thumbnail": "https://t7.baidu.com/it/u=1417024192,1312727626&fm=3035&app=3035&size=r2,1&q=75&n=0&g=3n&f=JPEG&fmt=auto&maxorilen2heic=2000000?s=2B08C40352C472E956BC89C6030070A3"
}
],
"shopping_results": [],
"knowledge_graph": {
"title": "笔记本电脑 - 百度百科",
"type": "工业产品",
"description": "笔记本电脑（Laptop），简称笔记本，又称“便携式电脑”、“手提电脑”、“掌上电脑”或“膝上型电脑”。特点是机身小巧，比台式机携带方便，是一种小型、便于携带的个人电脑。发展历史：1985年东芝T1100以约4.1千克、可由电池供电的IBM PC兼容机型确立翻盖形态。1991年苹果PowerBook普及掌托与指点杆。2008年MacBook Air以1.36千克、最薄4.06毫米定义超薄本。操作系统：笔记本电脑主要运行微软Windows，苹果机型搭载macOS，教育与轻办公领域见ChromeOS（搭载于Chromebook设备），部分机型运行Linux。此外，搭载ARM架构处理器的机型占比持续提升。产品功能：以便携计算为核心能力，集成屏幕、键盘、电池，支持文字处理、网页浏览与影音娱乐；按用途分商务本、游戏本、轻薄本与二合一本，后者可切换平板形态。",
"image": "https://gimg3.baidu.com/topone/src=https%3A%2F%2Fbkimg.cdn.bcebos.com%2Fsmart%2Ff703738da9773912b31bc15e86419118367adab444c1-bkimg-process%2Cv_1%2Crw_1%2Crh_1%2Cmaxl_800%2Cpad_1%3Fx-bce-process%3Dimage%2Fresize%2Cm_pad%2Cw_348%2Ch_348%2Ccolor_ffffff&refer=http%3A%2F%2Fwww.baidu.com&app=2011&size=w931&n=0&g=0n&er=404&q=75&fmt=auto&maxorilen2heic=2000000?sec=1794157200&t=6769ce7e2c2d7aa779e31904fc9da6c7",
"link": "http://www.baidu.com/link?url=socm-CjascsDO7JdbUctvMPRPWWT7Lz7iSOuwSNeZuJmSqhYXytwmm-sjx7Cm3JeW9ldJJja8GhV69Q-NAXyHCYth22EmRf8qzyUw6kOWjOK4Uo17aYIN40UYMUNsXUb"
},
"ai_overview": {
"title": "笔记本电脑",
"sections": [
{
"heading": "🧐 怎么根据用途挑类型",
"text": "不同使用场景适合的本子差别挺大，买之前先想清楚主要拿来干什么：\n1. 轻薄本/商务本：机身轻、续航长，适合日常办公、上课、写文档和看视频，性能够用但不适合大型游戏。\n2. 游戏本：性能强、散热好，能跑大型游戏和设计软件，但机身重、电池续航短，适合固定场所使用。\n3. 全能本：介于两者之间，性能比轻薄本强，便携性比游戏本好，适合既要办公又要偶尔剪视频或玩中型游戏的用户。\n4. 二合一/翻转本：屏幕可以360度翻折或拆成平板，适合需要手写、展示或频繁切换形态的场景。"
},
{
"heading": "🔍 关键配置怎么看",
"text": "不用记太复杂，重点盯住这5个参数：\n1. 处理器（CPU）：决定运行速度，办公选主流型号即可，游戏和设计建议选性能更强的标压处理器。\n2. 显卡（GPU）：集显适合日常使用，独显适合游戏、建模和视频渲染，显存和型号越高图形性能越强。\n3. 内存：16GB是目前主流，多任务切换更流畅；经常开多个软件或处理大文件可考虑32GB。\n4. 硬盘：固态硬盘（SSD）优先，容量至少512GB，1TB更从容，读写速度快，开机和加载软件都更快。\n5. 屏幕：看分辨率、刷新率和色域，办公选高色域护眼屏，游戏建议高刷新率，长时间使用注意低蓝光认证。"
},
{
"heading": "💰 不同预算怎么选",
"text": "按预算区间挑热门系列，能少踩坑：\n1. 3000~5000元：适合入门办公和学生党，可关注联想小新、惠普战66、Redmi Book等系列，满足文档处理、网课和轻度娱乐。\n2. 5000~8000元：中端全能区间，ThinkBook、小新Pro、华硕无畏、惠普战系列在此价位较均衡，性能和做工都更稳。\n3. 8000元以上：可选高端轻薄本如ThinkPad X系列、MacBook Air，或游戏本如拯救者Y系列、华硕天选/ROG，适合专业创作和重度游戏。\n\n\n\n\n品牌方面，联想、惠普、华硕、戴尔、ThinkPad、苹果等市场保有量大，售后网点多；苹果适合生态用户，Windows阵营选择更丰富。当前部分机型有国家补贴或平台促销，具体价格以实时页面为准，入手前多对比配置和用户评价。"
}
],
"sources": []
},
"hot_searches": [
{
"rank": 1,
"query": "习近平同加蓬总统恩圭马会谈",
"pinned": true,
"link": "https://www.baidu.com/s?wd=%E4%B9%A0%E8%BF%91%E5%B9%B3%E5%90%8C%E5%8A%A0%E8%93%AC%E6%80%BB%E7%BB%9F%E6%81%A9%E5%9C%AD%E9%A9%AC%E4%BC%9A%E8%B0%88&usm=5&ie=utf-8&rsv_pq=d28803e8000fdc52&oq=%E7%AC%94%E8%AE%B0%E6%9C%AC%E7%94%B5%E8%84%91&rsv_t=93b60Z2EjQu8pJOk5H7XubXgRzD9TxT0wrKmHwU0g4uxWAF19ZVFPV%2FJ4%2Fo&rqid=d28803e8000fdc52&rsf=88def09a43161ea48bb3787dd48120a8_1_15_1&rsv_dl=0_right_fyb_pchot_20811&sa=0_right_fyb_pchot_20811"
}
],
"pagination": {
"current_page": 1,
"results_per_page": 10,
"page_offset": 0,
"next_page_offset": 10,
"total_pages": 76
},
"__trimmed": "response capped for page display"
},
"__trimmed": "response capped for page display"
}What the Baidu API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Baidu web search results for a query: ranked organic results with the REAL destination URL (not Baidu's redirect), snippet, source and date; sponsored results with the advertiser's landing page; related searches; top stories; shopping cards; Baidu Baike knowledge panel; Baidu's AI answer; Baidu Hot Search (百度热搜). Filters: results per page (10-50), page/offset, time window or custom date range, site and file type, plus Baidu's own query operators. | SEO teams call search to get baidu web search results for a query. | q, page, num, offset, time_period, ... |
| news | Baidu News (百度资讯) results: headline, real article URL, publisher, snippet, publish time and thumbnail, 10 per page, by relevance or newest first. Includes Baidu's own count of matching articles. | Content strategists call news to get baidu News (百度资讯) results. | q, page, sort |
| images | Baidu Images (百度图片) results: original image URL, thumbnail, size, format, title and the page the image was found on, 30 per page, plus Baidu's total image count. | Rank trackers call images to get baidu Images (百度图片) results. | q, page |
| videos | Baidu Video search (百度视频) results: video title, the real video page URL (Bilibili, Haokan, iQIYI, Xigua…), duration, platform, publish date and thumbnail, about 10 per page. | AI answer-monitoring tools call videos to get baidu Video search (百度视频) results. | q, page |
| suggest | Baidu search autocomplete: the query completions Baidu offers as you type. Fast and cheap — useful for Chinese keyword research. | SEO teams call suggest to get baidu search autocomplete. | q |
| resolve_link | Turn a Baidu redirect link (https://www.baidu.com/link?url=…) into the destination URL it points to. Ad click links (baidu.php) are not followed. | Content strategists call resolve_link to turn a Baidu redirect link (https://www.baidu.com/link?url=…) into the destination URL it poi…. | url |
Call search from your stack
curl -X POST https://api.reefapi.com/baidu/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"q":"笔记本电脑"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/baidu/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"q": "笔记本电脑"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/baidu/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"q": "笔记本电脑"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.baidu.search with {"q":"笔记本电脑"}.Who uses this API and why
- SEO teams track where a site ranks on Baidu for Chinese keywords, page by page up to 50 results per call.
- Market researchers read what Chinese searchers see for a brand: results, ads and the advertisers behind them, top stories.
- Keyword research tools pull Baidu autocomplete and related searches to collect the phrasing Chinese users actually type.
- AI and RAG pipelines use search and news as a Chinese-language retrieval source with real URLs and dates.
Questions developers ask before integrating
Is this an official Baidu API?
No. Baidu has no public web-search API for developers outside China. ReefAPI is an independent service that returns what Baidu's public results page shows, as JSON.
Do I get the real URL or Baidu's redirect?
Both. url is the destination, read from the page itself, and link is Baidu's baidu.com/link?url=… redirect for the same result. Store url; the redirect tokens change between calls.
Are ads separated from organic results?
Yes. Sponsored results are only in ads[], with title, description, landing_url (the advertiser's page) and placement (top, middle or bottom). The engine never follows an ad click link.
How many results can I get per query?
Up to 50 per call with num=50, and Baidu itself lists at most 76 pages. Use page or offset to go deeper. Positions are Baidu's own rank numbers, so they can skip the slots taken by Baidu's widgets.
Can I search one site or a date range?
Yes. site=zhihu.com restricts to a domain (Baidu also matches the same name under a country suffix, such as apple.com.cn). time_period=day|week|month|year or date_from/date_to set Baidu's time filter. Operators typed into q work too.
Does it work for English queries?
Yes, but the index is Baidu's: English queries return the English pages Baidu has, mixed with Chinese pages about the topic. Baidu News may hold very few English articles; total_results tells you how many it has.
What is the Baidu API?
Baidu API is a ReefAPI endpoint group for baidu (百度) search results as json: web results with the real url, ads, related searches, news, images, videos and autocomplete. It returns live JSON through POST requests under /baidu/v1.
Is the Baidu API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Baidu calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Baidu login or account?
No login to Baidu is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Baidu data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Baidu API use?
Baidu actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Baidu from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call baidu actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Baidu API a Baidu scraper?
It is the managed alternative to a DIY Baidu scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same baidu (百度) search results as json: web results with the real url, ads, related searches, news, images, videos and autocomplete back as clean JSON.
Why does my Baidu scraper keep getting blocked?
Most Baidu scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.