Bing Copilot API: 답변, 출처, 상품 카드 - querying.ai

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


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

요청

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은 시청 페이지입니다. 예시:

{
  "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를 실행합니다.

searchQueries, ads, shopping은 효과가 없습니다. analysis는 422 VALIDATION_ERROR로, html은 422 EVIDENCE_UNSUPPORTED로 거절됩니다. Markdown과 원본 응답을 참고하세요.

관련 문서