---
title: "Search"
description: "Baidu 검색 결과 페이지 하나를 가져옵니다. 모든 블록이 페이지 순서대로 옵니다."
---

> Every apinoa docs page as markdown: https://apinoa.com/llms.txt (all in one file: https://apinoa.com/llms-full.txt; this API family in one file: https://apinoa.com/docs/serp/llms.txt)

```http
GET | POST /v1/baidu/search
```

파라미터는 `GET`의 쿼리 문자열로도, `POST`의 JSON 본문으로도 보낼 수 있습니다. 둘은 같습니다.

## 요청

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

```js tab="JavaScript"
const params = new URLSearchParams({ q: "人工智能" });
const res = await fetch(`https://gateway.apinoa.com/v1/baidu/search?${params}`, {
  headers: { "x-api-key": process.env.APINOA_API_KEY },
});
const { success, data, error } = await res.json();
```

```python tab="Python"
import os

import requests

res = requests.get(
    "https://gateway.apinoa.com/v1/baidu/search",
    params={"q": "人工智能"},
    headers={"x-api-key": os.environ["APINOA_API_KEY"]},
)
body = res.json()
```

## 파라미터

| Parameter | Type | Required | Notes |
|---|---|---|---|
| `country` | enum |  | The market, as an ISO 3166 country code. `CN` |
| `cursor` | string |  | The previous page's `cursor`. Pass it alone for the next page. |
| `image` | string |  | An image URL: a reverse-image search instead of `q` (`type=image`). |
| `limit` | integer 1–50 |  | Results wanted (default 10, at most 50). More than one page is charged per page. |
| `q` | string |  | The query, search operators included. |
| `timeRange` | enum |  | Only results from this past period. `hour` `day` `week` `month` `year` |
| `type` | enum |  | What 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: https://apinoa.com/openapi.json

## 응답

`data`에 [`ResultsPage`](/docs/api-reference/serp/response-schema#resultspage)를 돌려줍니다. 실제 응답을 줄인 것입니다. 배열은 앞쪽 항목만 남기고 긴 텍스트는 잘랐습니다.

```json
{
  "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"
  }
}
```

## 에러

| 상태 | 코드 | 의미 |
|---|---|---|
| 400 | `INVALID_CURSOR` | 이 오퍼레이션이 돌려준 `cursor`가 아닙니다. `cursor` 없이 처음부터 다시 호출하세요. |
| 400 | `INVALID_PARAMS` | 파라미터가 없거나, 알 수 없거나, 범위를 벗어났거나, 이 엔진이 받지 않는 값입니다. 메시지에 이름이 나옵니다. |
| 401 | `UNAUTHORIZED` | `x-api-key` 헤더가 없거나, 폐기되었거나 알 수 없는 키입니다. |
| 402 | `INSUFFICIENT_BALANCE` | 잔액이 이 호출 비용에 모자랍니다. 대시보드에서 충전하세요. |
| 429 | `MARKETPLACE_SATURATED` | 동시 호출이 너무 많습니다. `Retry-After` 초만큼 기다린 뒤 다시 시도하세요. |
| 502 | `UPSTREAM_ERROR` | 엔진이 쓸 수 없는 응답을 보냈습니다. 간격을 두고 다시 시도하세요. |
| 503 | `SERVICE_UNAVAILABLE` | 일시적인 장애입니다. 간격을 두고 다시 시도하세요. |

모든 코드는 [Errors](/docs/errors)에 있습니다. 실패한 호출은 과금되지 않습니다.

## 가격

**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](https://apinoa.com/en/pricing); the rate steps down above 1,000 calls a day.

## 참고

- `q` 대신 `image` URL과 `type=image`를 넘기면 이미지로 검색(역방향 이미지 검색)합니다.
- `limit`이 한 페이지보다 크면 다음 페이지들도 읽으며, 페이지마다 1단위입니다.