Bing 검색 결과와 AI 요약 API (BING_SEARCH) - querying.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`).

요청

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 } } }'

태스크는 비동기로 실행됩니다. 결과는 비동기 태스크에 설명한 방법으로 읽으세요.

파라미터

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

응답

예:

{
  "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`를 읽으세요.

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

제한과 오류

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

관련 문서

Microsoft의 채팅 답변을 받는 Bing Copilot
Markdown과 원본 응답