Bing Search API의 결과를 페이징하는 방법
경고
2020년 10월 30일에 Bing Search API가 Azure AI 서비스에서 Bing Search Services로 이동되었습니다. 이 문서는 참조용으로만 제공됩니다. 업데이트된 문서는 Bing search API 문서를 참조하세요. Bing 검색을 위한 새 Azure 리소스 만들기에 대한 지침은 Azure Marketplace를 통해 Bing Search 리소스 만들기를 참조하세요.
Bing Web, Custom, Image, News 또는 Video Search API에 대한 호출을 보내면 Bing에서 쿼리와 관련이 있을 수 있는 총 결과 수의 하위 집합을 반환합니다. 예상되는 총 사용 가능한 결과 수를 가져오려면 답변 개체의 totalEstimatedMatches 필드에 액세스해야 합니다.
예를 들면 다음과 같습니다.
{
"_type" : "SearchResponse",
"webPages" : {
"webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=3A43CA...",
"totalEstimatedMatches" : 262000,
"value" : [...]
}
}
검색 결과 페이징
사용 가능한 결과를 페이징하려면 요청을 보낼 때 count 및 offset 쿼리 매개 변수를 사용합니다.
참고
- Bing Video, Image 및 News API에서의 페이징은 일반 비디오(
/video/search), 뉴스(/news/search) 및 이미지(/image/search) 검색에만 적용됩니다. 최신 항목 및 범주를 통한 페이징은 지원되지 않습니다. TotalEstimatedMatches필드는 현재 쿼리에 대한 총 검색 결과 수의 예상 값입니다.count및offset매개 변수를 설정하면 이 예상 값이 바뀔 수 있습니다.
| 매개 변수 | Description |
|---|---|
count |
응답에서 반환할 결과의 수를 지정합니다. count의 기본값 및 요청할 수 있는 최대 결과 수는 API에 따라 달라집니다. 다음 단계에서 이러한 값을 참조 설명서에서 찾을 수 있습니다. |
offset |
건너뛸 결과의 수를 지정합니다. offset은 0부터 시작하며 (totalEstimatedMatches - count)보다 작아야 합니다. |
예를 들어 페이지당 15개의 문서를 표시하려면 count를 15로, offset을 0으로 설정하여 결과의 첫 번째 페이지를 가져오면 됩니다. 이후 API 호출마다 offset이 15씩 증가합니다. 다음은 오프셋 45에서 시작하여 웹 페이지 15개를 요청하는 예제입니다.
GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&count=15&offset=45&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
Host: api.cognitive.microsoft.com
count 기본값을 사용하는 경우 API 호출에서 offset 쿼리 매개 변수만 지정해야 합니다.
GET https://api.cognitive.microsoft.com/bing/v7.0/search?q=sailing+dinghies&offset=45&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
Host: api.cognitive.microsoft.com
Bing Image 및 Video API를 사용하는 경우 nextOffset 값을 사용하여 중복 검색 결과를 방지할 수 있습니다. Images 또는 Videos 응답 개체에서 값을 가져온 다음 요청에서 offset 매개 변수와 함께 사용합니다.
참고
Bing Web Search API는 웹 페이지, 이미지, 비디오, 뉴스를 포함할 수 있는 검색 결과를 반환합니다. Bing Web Search API의 검색 결과를 페이징하는 경우에는 이미지 또는 뉴스와 같은 다른 답변 유형이 아닌 WebPages만 페이징할 수 있습니다. WebPage 개체의 검색 결과에는 다른 답변 유형에도 표시되는 결과가 포함될 수 있습니다.
필터 값을 지정하지 않고 responseFilter 쿼리 매개 변수를 사용하는 경우 count 및 offset 매개 변수를 사용하지 마세요.