Suggestions
Get what Seznam's search box suggests for a query.
GET | POST /v1/seznam/suggestionsSend parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.
Request
curl -G "https://gateway.apinoa.com/v1/seznam/suggestions" \
--data-urlencode "q=počasí" \
-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. CZ |
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": "seznam",
"query": "počasí",
"suggestions": [
{
"text": "počasí idnes",
"type": "fulltext",
"ext": {"source": "global", "count": 80016, "suggestCount": 72405, "visitorCount": 64658}
},
{"text": "počasí", "type": "fulltext+weather/location", "ext": {"source": "global+hintservers"}}
],
"country": "CZ"
}
}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.