> ## 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 Copilot API: 답변, 출처, 상품 카드

> Microsoft Copilot에 질문하고 답변, 인용 페이지, 상품 카드, 장소, 이미지, 검색어를 받습니다.

`BING_COPILOT`은 copilot.com의 Copilot 채팅에 웹 검색을 항상 켠 상태로 묻습니다. 계정이나 로그인은 쓰지 않습니다.

| | |
| - | - |
| taskType | `BING_COPILOT` |
| 별칭 | `COPILOT` |
| 읽는 필드 | `prompt` (없으면 `query`) |
| 크레딧 | 1 |
| 국가 | 선택, 기본값 `US`. |

## 요청

```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_COPILOT", "payload": { "prompt": "best CRM for a small team", "country": "US" } }'
```

## 응답

| 필드 | 타입 | 설명 |
| - | - | - |
| `text` | string | 답변. |
| `sources` | array | Copilot이 인용한 페이지: `position`, `url`, `label`. |
| `shoppingCards` | array | 상품 카드. 항상 있으며, 없으면 비어 있습니다. |
| `map` | array | 장소: `position`, `name`, `placeId`, `location`, `layerLabel`. 항상 있으며, 없으면 비어 있습니다. |
| `searchQueries` | string\[] | Copilot이 실행한 검색. 항상 있으며, 없으면 비어 있습니다. |
| `images` | array | 이미지 캐러셀: `title`, `url`, `image`, `thumbnail`, `medium`, `source`, `image_width`, `image_height`. |
| `videos` | array | 동영상 캐러셀: `title`, `url`, `medium`, `thumbnail`, `source`, `duration`. |
| `markdown` | string | Markdown 답변. `include.markdown`일 때만. |
| `rawResponse` | array | 스트림 이벤트. `include.rawResponse`일 때만. |

쇼핑 질문은 페이지를 인용하지 않고 상품 카드만 반환하는 경우가 많으므로 `sources: []`도 정상 답변입니다. 각 `shoppingCards` 항목에는 `products`가 있고, 상품 위치는 모든 카드에 걸쳐 이어집니다. 상품에는 Copilot의 `review`(구매자 평가 요약과 그 출처 스토어), `prosAndCons`, `curationInfo`가 붙으며, Copilot에 없으면 각각 `null`입니다. `images`에서 `url`은 이미지가 속한 페이지, `image`는 이미지 파일이고, `videos`에서 `url`은 시청 페이지입니다.

예시:

```json theme={"theme":"css-variables"}
{
  "text": "For a small team, HubSpot CRM and Pipedrive are easy to start with ...",
  "sources": [{ "position": 1, "url": "https://www.example.com/crm-guide", "label": "CRM guide for small teams" }],
  "shoppingCards": [],
  "map": [],
  "searchQueries": ["best CRM for small teams"]
}
```

`include.markdown`을 보내면 `markdown`은 Copilot이 이미지 캐러셀을 보여 준 자리에 `![title](image)` 줄을 넣고, 각 동영상은 링크된 썸네일로 넣습니다.

## include 플래그

| 플래그 | 효과 |
| - | - |
| `markdown` | `markdown`을 추가합니다. |
| `rawResponse` | `rawResponse`를 추가합니다. |
| `citationAnalysis` | 답변에 [Citation Analysis](/ko/research/citation-analysis.md)를 실행합니다. |

`searchQueries`, `ads`, `shopping`은 효과가 없습니다. `analysis`는 `422 VALIDATION_ERROR`로, `html`은 `422 EVIDENCE_UNSUPPORTED`로 거절됩니다. [Markdown과 원본 응답](/ko/engines/response-options.md)을 참고하세요.

## 관련 문서

* [Bing Copilot 제품 페이지](https://querying.ai/ko/engines/bing-copilot)
* [Bing 검색](/ko/engines/bing-search.md)
* [엔진 개요](/ko/engines/overview.md)


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