Autosuggest API v7 response objects
For a list of possible objects, see In this article in the right pane.
If the request succeeds, the top-level object in the response is the Suggestions object. And if the request fails, the top-level object in the response is the ErrorResponse object.
Note
Because URL formats and parameters are subject to change without notice, use all URLs as-is. You should not take dependencies on the URL format or parameters except where noted.
Error
Defines the error that occurred.
Name | Value | Type |
---|---|---|
code | The error code that identifies the category of error. For a list of possible codes, see Error codes. | String |
message | A description of the error. | String |
moreDetails | A description that provides additional information about the error. | String |
parameter | The query parameter in the request that caused the error. | String |
subCode | The error code that identifies the error. For example, if code is InvalidRequest, subCode may be ParameterInvalid or ParameterInvalidValue. |
String |
value | The query parameter's value that was not valid. | String |
ErrorResponse
The top-level object that the response includes when the request fails.
Name | Value | Type |
---|---|---|
_type | Type hint, which is set to ErrorResponse. | String |
errors | A list of errors that describe the reasons why the request failed. | Error[] |
QueryContext
Defines the query string that Bing used for the request.
Name | Value | Type |
---|---|---|
adultIntent | Not used. | Boolean |
alterationOverrideQuery | Not used. | String |
alteredQuery | Not used. | String |
askUserForLocation | Not used. | String |
originalQuery | The user's query term. | String |
SearchAction
Defines a query search suggestion.
SuggestionGroup
Defines a group of suggestions of the same type.
Name | Value | Type |
---|---|---|
name | The name of the group. The name identifies the type of suggestions that the group contains. For example, web search suggestions. The following are the possible group names:
|
String |
searchSuggestions | A list of up to 8 suggestions. If there are no suggestions, the array is empty. You must display all suggestions in the order provided. The list is in order of decreasing relevance. The first suggestion is the most relevant and the last suggestion is the least relevant. The size of the list is subject to change. |
SearchAction[] |
Suggestions
The top-level object that the response includes when the request succeeds.
If the service suspects a denial of service attack, the request succeeds (HTTP status code is 200 OK). However, the body of the response is empty.
Name | Value | Type |
---|---|---|
_type | The type hint, which is set to Suggestions. | String |
queryContext | The user's query string. | QueryContext |
suggestionGroups | A list of suggested query strings grouped by type. For example, web search suggestions. | SuggestionGroup[] |
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기