> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bing 검색 결과와 AI 요약 API (BING_SEARCH)

> bing.com 자연 검색 결과, 광고, 관련 검색어와 함께 Bing이 그 위에 보여주는 AI 요약을 받습니다.

`BING_SEARCH`는 검색어에 대한 bing.com 결과 페이지를 불러와 자연 검색 결과, 광고, 관련 검색어를 반환하고, Bing이 그 위에 그리는 AI 요약을 `aioverview`로 담습니다. 계정이나 로그인은 쓰지 않습니다.

| | |
| - | - |
| `taskType` | `BING_SEARCH`(별칭 `BING`, `BING_COPILOT_SEARCH`) |
| 입력 | `query` 또는 `prompt`(필수), 최대 4,000자, `country`, `include` |
| 크레딧 | 태스크당 1 |
| 국가 | 기본값 `US`. 모든 ISO 3166-1 alpha-2 코드를 받습니다. |
| 위치 | 지원하지 않습니다(`422 LOCATION_UNSUPPORTED`). |

## 요청

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "BING_SEARCH", "payload": { "query": "how does a heat pump work in cold weather", "country": "US", "include": { "markdown": true } } }'
```

태스크는 비동기로 실행됩니다. 결과는 [비동기 태스크](/ko/concepts/async-tasks.md)에 설명한 방법으로 읽으세요.

## 파라미터

| 필드 | 필수 | 설명 |
| - | - | - |
| `query` | 예, 또는 `prompt` | 검색어, 최대 4,000자. |
| `prompt` | 예, 또는 `query` | `query` 대신 받습니다. 요청에 둘 다 있으면 `BING_SEARCH`는 `prompt`를 읽습니다. |
| `country` | 아니요 | 검색할 시장. 기본값은 `US`입니다. |
| `include.markdown` | 아니요 | `true`면 제목, 목록, 표를 유지한 요약인 `aioverview.markdown`을 더합니다. |
| `include.rawResponse` | 아니요 | `true`면 결과 페이지 전체 HTML을 `rawContent`로 더합니다. |

## 응답

예:

```json theme={"theme":"css-variables"}
{
  "surface": "bing_search",
  "organicResults": [
    { "position": 1, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "date": "Aug 3, 2026", "page": 1 }
  ],
  "ads": [{ "position": 1, "title": "...", "link": "https://...", "displayedLink": "...", "description": "...", "blockPosition": "top" }],
  "relatedSearches": [{ "query": "...", "link": "https://www.bing.com/search?q=..." }],
  "aioverview": {
    "text": "Heat pumps move heat instead of generating it [1]. ...",
    "sources": [{ "position": 1, "url": "https://...", "label": "..." }],
    "citationPills": [{ "citationPillId": 1, "position": 1, "url": "https://...", "label": "...", "domain": "example.com" }],
    "markdown": "..."
  },
  "text": "Heat pumps move heat instead of generating it [1]. ...",
  "sources": [{ "position": 1, "url": "https://...", "label": "..." }]
}
```

| 필드 | 설명 |
| - | - |
| `surface` | 항상 `bing_search`입니다. |
| `organicResults` | 페이지의 자연 검색 결과. |
| `ads` | 광고. 페이지에 없으면 생략합니다. |
| `relatedSearches` | 관련 검색어. 페이지에 없으면 생략합니다. |
| `aioverview` | Bing의 AI 요약. Bing이 보여주지 않았으면 `null`입니다. |
| `aioverview.text` | 요약. `[n]`은 `aioverview.sources[n-1]`을 가리킵니다. |
| `aioverview.sources` | 요약이 인용한 페이지. |
| `aioverview.citationPills` | 인라인 인용 뒤의 출처마다 한 항목이며, 함께 인용된 출처는 같은 `citationPillId`를 공유합니다. 요약에 인라인 인용이 없으면 생략합니다. |
| `aioverview.markdown` | `include.markdown: true`일 때. |
| `rawContent` | `include.rawResponse: true`일 때 결과 페이지 HTML. |
| `text`, `sources` | `aioverview.text`와 `aioverview.sources`의 지원 중단 사본이며, 요약이 없으면 비어 있습니다. 새 코드에서는 `aioverview`를 읽으세요. |

> [!WARNING]
>
> `aioverview: null`은 해당 검색어에 Bing이 AI 요약을 보여주지 않았다는 뜻입니다. 오류가 아니며, 주변 결과는 그대로 반환됩니다.

## 제한과 오류

* 4,000자를 넘는 `query`(또는 `prompt`)는 `422 VALIDATION_ERROR`를 반환합니다.
* Bing이 모든 검색어에 요약을 쓰지는 않습니다. 검색형 질문이 지시형보다 요약을 더 자주 받습니다. 요약을 보여줄 때 Bing은 자연 검색 결과 일부를 다음 페이지로 넘기므로, 그런 페이지에서는 `organicResults`가 짧습니다.
* 그 밖의 요청 오류는 [오류](/ko/concepts/errors.md)에 정리되어 있습니다.

## 관련 문서

* Microsoft의 채팅 답변을 받는 [Bing Copilot](/ko/engines/bing-copilot.md)
* [Markdown과 원본 응답](/ko/engines/response-options.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.