Suggestions
Get what Yandex's search box suggests for a query.
GET | POST /v1/yandex/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/yandex/suggestions?q=moscow" \
-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 RU TR KZ BY UA UZ DE GB FR | |
lang | enum | Interface language: en (yandex.com, the default) or ru (yandex.ru). en ru |
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": "yandex",
"query": "moscow",
"country": "US",
"lang": "en",
"suggestions": [{"text": "moscow", "type": "fulltext"}, {"text": "moscow time", "type": "fulltext"}]
}
}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.