Bing Autocomplete API
Get structured Bing search suggestions for a query and search market.
Endpoint
GET https://api.goanyapi.com/api/v1/bing-autocompleteWith the current configuration, each successful request costs 3 credits.
Authentication
Authorization: Bearer YOUR_API_KEYRequest Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | Yes | — | Query with up to 200 characters; meaningful leading and trailing spaces are preserved |
mkt | string | No | en-US | Search market in language-country format, for example en-US or zh-CN |
mkt affects suggestion language, regional spelling, popularity, and ordering. It is optional, but the API always uses the stable en-US default when it is omitted.
Request Example
The following query ends with an encoded space after image:
GET /api/v1/bing-autocomplete?q=ai%20image%20&mkt=en-US
Authorization: Bearer YOUR_API_KEYResponse Example
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "bing-autocomplete",
"remainingCredits": 999,
"query": {
"q": "ai image ",
"mkt": "en-US"
},
"suggestions": [
"image creator",
"ai image editor",
"ai image generator free",
"ai image detector",
"ai image upscaler",
"ai image enhancer",
"ai image checker",
"ai image to video",
"ai image creation",
"ai image search",
"ai image to image"
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
data.endpoint | string | Fixed value: bing-autocomplete |
data.costCredits | number | Credits consumed by this request |
data.remainingCredits | number | Remaining credits after deduction |
data.query.q | string | Query exactly as sent, including meaningful spaces |
data.query.mkt | string | Search market actually used |
data.suggestions | string[] | Suggestions in returned order |
Suggestion strings are returned unchanged. The API does not prepend q, reorder values, or combine the query with a suggestion.
Validation and Billing
-
qmust contain non-whitespace content and may contain at most 200 characters. -
A supplied
mktmust use language-country casing such asen-US. The current request cost follows the API configuration shown on this page. -
Empty results, validation failures, authentication failures, failed requests, and invalid responses cost 0 credits.