Suggestions
Get what Bing's search box suggests for a query.
GET | POST /v1/bing/suggestionsSend parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.
Request
curl "https://gateway.apinoa.com/v1/bing/suggestions?q=running+shoes&country=US" \
-H "x-api-key: $APINOA_API_KEY"Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
q | string | yes | The query, search operators included. |
country | enum | The market, as an ISO 3166 country code. US GB CA AU DE FR IT AT JP KR | |
lang | string | Interface language. |
The same parameters, and every response type, are in the OpenAPI document.
Response
Returns Suggestions in data. A real response, shortened: arrays keep their first entries and long text is cut.
{
"success": true,
"data": {
"engine": "bing",
"query": "running shoes",
"suggestions": [{"text": "running shoes near me", "type": "AS"}, {"text": "running shoes in elizabeth", "type": "LMSQ"}],
"country": "US",
"lang": "en"
}
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_PARAMS | A parameter is missing, unknown or out of range, or the engine does not take it. The message names it. |
| 401 | UNAUTHORIZED | The x-api-key header is missing, or the key is revoked or unknown. |
| 402 | INSUFFICIENT_BALANCE | The balance does not cover this call. Top up in the dashboard. |
| 429 | MARKETPLACE_SATURATED | Too many concurrent calls. Retry after the Retry-After seconds. |
| 502 | UPSTREAM_ERROR | The engine answered with something unusable. Retry with backoff. |
| 503 | SERVICE_UNAVAILABLE | A temporary failure. Retry with backoff. |
Every code is listed in Errors. Failed calls are not billed.
Pricing
Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.