Apinoa Docs

Search

Get one Baidu results page, with every block in page order.

View raw .mdx
GET | POST /v1/baidu/search

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl -G "https://gateway.apinoa.com/v1/baidu/search" \
  --data-urlencode "q=人工智能" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

ParameterTypeRequiredNotes
countryenumThe market, as an ISO 3166 country code. CN
cursorstringThe previous page's cursor. Pass it alone for the next page.
imagestringAn image URL: a reverse-image search instead of q (type=image).
limitinteger 1–50Results wanted (default 10, at most 50). More than one page is charged per page.
qstringThe query, search operators included.
timeRangeenumOnly results from this past period. hour day week month year
typeenumWhat to search: web results (default), news, images, videos or image for a reverse-image search. web news images videos image

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns ResultsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "success": true,
  "data": {
    "engine": "baidu",
    "query": "人工智能",
    "type": "web",
    "outcome": "results",
    "country": "CN",
    "device": "desktop",
    "page": 1,
    "items": [
      {
        "type": "ad",
        "rank": 1,
        "block": "top",
        "url": "https://www.extremevision.com.cn/marketplace/?source=baidu&plan=PC-tongyongci-2&unit=2%E3%80%90tongyongci%E3%80%91shijueshibie&keyword=rengongzhinengaishijue&e_…",
        "title": "人工智能ai视觉-专注AI视觉算法解决方案!",
        "snippet": "人工智能ai视觉 找极视角,全球开创AI视觉算法商城,15000+成熟算法,准确率超90%,全新算法定制仅需8-12周!服务超过3000+企业,.. 应用方案: 图像识别 视频分析 深度学习 视觉语言大模型 更多 多快好省 去看看 多快好省 1500+成熟算法 精准度≥90% 去看看 精准度≥90% 100+行业覆盖…",
        "advertiser": "极视角科技",
        "displayUrl": "extremevision.com.cn",
        "ext": {"company": "山东极视角科技股份有限公司", "searches": ["ai+人工智能", "ai智能体"]},
        "thumbnail": "https://ms.bdimg.com/pacific/0/pic/1494046521_-833442663.jpg?x=0&y=0&h=340&w=510&vh=340.00&vw=510.00&oh=340.00&ow=510.00"
      },
      {
        "type": "ad",
        "rank": 2,
        "block": "top",
        "url": "https://www.workbuddy.cn/?fromSource=gwzcw.12411645.12411645.12411645&utm_medium=cpc&utm_id=gwzcw.12411645.12411645.12411645",
        "title": "腾讯WorkBuddy,免部署安装即用,一分钟直连IM",
        "snippet": "WorkBuddy 官方版 版本:4.24.0 系统:win/mac 大小:447MB AI 专家团 全场景办公 一键下载 双11大促",
        "advertiser": "WorkBuddy",
        "displayUrl": "workbuddy.cn",
        "ext": {"company": "腾讯云计算(北京)有限责任公司", "searches": ["ai+人工智能", "ai智能体"]},
        "thumbnail": "https://t7.baidu.com/it/u=2722534176,2919570617&fm=74&app=80&size=f256,256&n=0&f=JPEG&fmt=auto?s=0BA7572257727B8010765A410300C0FE&sec=1779901200&t=45b76cd0194fa…"
      },
      {
        "type": "knowledgePanel",
        "rank": 3,
        "title": "人工智能 - 百度百科",
        "subtitle": "智能科学与技术专业术语",
        "description": "简介:人工智能(Artificial Intelligence,缩写AI)是研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的一门新技术科学,是计算机科学的一个分支。它企图了解智能的实质,生产出能以人类智能相似方式做出反应的智能机器,该领域的研究包括机器人、语言识别、图像识别、自然语言处理和专家系统等…",
        "source": {"url": "https://baike.baidu.com/item/%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD/9180", "title": "百度百科"},
        "images": [
          "https://gimg3.baidu.com/topone/src=https%3A%2F%2Fbkimg.cdn.bcebos.com%2Fsmart%2Ffaedab64034f78f0f736f375f8661d55b319eac4b6a4-bkimg-process%2Cv_1%2Crw_1%2Crh_1%2…"
        ],
        "links": [
          {
            "url": "https://baike.baidu.com/item/%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD/9180?anchor=1#1",
            "title": "定义详解"
          },
          {
            "url": "https://baike.baidu.com/item/%E4%BA%BA%E5%B7%A5%E6%99%BA%E8%83%BD/9180?anchor=2#2",
            "title": "研究价值"
          }
        ]
      },
      {
        "type": "other",
        "rank": 4,
        "kind": "jy_xueshu_journal_atom",
        "title": "人工智能 - 官方网站",
        "text": "人工智能 - 官方网站 官方 数据库收录: RCCSE,知网,万方,维普 ISSN: 2096-5036 简介: 《人工智能》由工业和信息化部主管,中国电子信息产业发展研究院、赛迪工业和信息化研究院(集团)有限公司主办 在线投稿 期刊相关论文 期刊合作 百度学术",
        "links": [
          {
            "url": "http://www.baidu.com/link?url=yuMYqxNOu_ZAExp-TZx5YK_c-u8IOQC1ICsaYiO3fHRlTM3Q8K5zJ-kYNdkgsKOap7RdrEM6O6b5nUxWqhI_10yOU-z1V_-5l5zSYTYTFn3",
            "title": "人工智能 - 官方网站"
          },
          {"url": "http://trust.baidu.com/vstar/official/intro", "title": "官方"}
        ]
      },
      {"type": "relatedSearches", "rank": 9, "queries": ["ai培训班一般培训什么", "AI"]},
      {
        "type": "organic",
        "rank": 10,
        "position": 1,
        "url": "https://www.sjchess.com/detail/241059.html",
        "title": "《人工智能》电影免费在线观看-高清完整版-天堂电影网",
        "snippet": "《人工智能》电影免费在线观看-高清完整版-天堂电影网 人工智能",
        "site": "www.sjchess.com/detail/2...",
        "displayUrl": "sjchess.com",
        "thumbnail": "https://gips1.baidu.com/it/u=1200376025,2806358308&fm=3026&app=3026&size=re3,2&q=75&n=0&g=4n&f=JPEG&fmt=auto&maxorilen2heic=2000000?s=5231E16867BDBA7D12D9010A01…"
      }
    ],
    "cursor": "a5fMX1ZbYCOfkMZQz0KPY1nAb5M7pflrC0UxYf9Kv8IqfmVVd0u6fEO96EZVg_krOi_UAejM95p-tMIxWUbGslOXPZ4ncH_lDT9hYTmLTtcW2zeLCRe4vr3kLtOWY_EC37N-GK_9MUrl-xOOzXX2RCPPGg",
    "fetchedAt": "2026-10-30T00:57:31.973Z"
  }
}

Errors

StatusCodeMeaning
400INVALID_CURSORThe cursor is not one this operation returned. Start again without it.
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
503SERVICE_UNAVAILABLEA temporary failure. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.0012 per call, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. List price; the rate steps down above 1,000 calls a day.

Notes

  • type=image with an image URL instead of q runs a reverse-image search.
  • limit above one page reads further pages, one unit each.

On this page