Search
Get one Seznam results page, with every block in page order.
GET | POST /v1/seznam/searchSend 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/search" \
--data-urlencode "q=počasí praha" \
-H "x-api-key: $APINOA_API_KEY"Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
country | enum | The market, as an ISO 3166 country code. CZ | |
cursor | string | The previous page's cursor. Pass it alone for the next page. | |
device | enum | Which page to read: the desktop (default) or the mobile one. desktop mobile | |
limit | integer 1–100 | Results wanted (default 10, at most 100). More than one page is charged per page. | |
q | string | The query, search operators included. | |
timeRange | enum | Only results from this past period. hour day week month year | |
type | enum | What to search: web results (default), news, images or videos. web news images videos |
The same parameters, and every response type, are in the OpenAPI document.
Response
Returns ResultsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.
{
"success": true,
"data": {
"engine": "seznam",
"query": "počasí praha",
"type": "web",
"country": "CZ",
"device": "desktop",
"fetchedAt": "2026-10-30T00:57:52.440Z",
"outcome": "results",
"totalResults": 12000000,
"page": 1,
"items": [
{
"type": "other",
"rank": 1,
"kind": "weather",
"title": "Praha",
"text": "Jasno, denní teploty v rozmezí 5 až 10 °C. Ze severu povane slabý vítr…",
"ext": {
"current": {
"bio": 1,
"feelTemp": 4.343411571995779,
"feelTemp2": 4.343411571995783,
"fromStation": false,
"icon": 0,
"isDay": false,
"precip": 0,
"pressure": 1031.1091208148287,
"temp": 4.343411571995781,
"uv": 0,
"wind": 0.5696404089287476,
"windDir": 329,
"windGust": 1.9975428816001073
},
"current_aprox": {
"bio": 1,
"feelTemp": 4.343411571995779,
"feelTemp2": 4.343411571995783,
"fromStation": false,
"icon": 0,
"isDay": false,
"precip": 0,
"pressure": 1031.1091208148287,
"temp": 4.343411571995781,
"uv": 0,
"wind": 0.5696404089287476,
"windDir": 329,
"windGust": 1.9975428816001073
},
"daily": [
{
"dataHours": 9,
"icon": 0,
"localDate": "2026-10-29",
"precip": 0,
"precipType": 0,
"snowPrecip": 0,
"summary": "Jasno, denní teploty v rozmezí <b class=sec>5 až 10 °C</b>. Ze severu…",
"sunrise": "06:44",
"sunset": "16:46",
"tempMax": 10.464210939698205,
"tempMin": 5.089965024221442,
"wind": 1.9,
"windDir": 346
}
],
"entries": [
{
"dayId": 0,
"icon": 0,
"isDay": false,
"localDate": "2026-10-29",
"localTime": "16:00",
"precip": 0,
"snowPrecip": 0,
"temp": 10.464210939698205,
"wind": 1.2,
"windDir": 307
}
],
"place": {
"TZoffset": 1,
"lat": 50.083549,
"localNow": "2026-10-30T01:54:38+01:00",
"lon": 14.434141,
"name": {
"area": "Pražská plošina",
"coun": "Česko",
"dist": "Hlavní město Praha",
"muni": "Praha",
"quar": "Praha 1, Praha, Hlavní město Praha",
"regi": "Hlavní město Praha",
"stre": "Vrchlického sady, Praha, Hlavní město Praha",
"ward": "Nové Město, Praha, Hlavní město Praha"
},
"seo": {
"coun": "cesko",
"isCz": true,
"muni": "praha",
"placeId": "muni_3468",
"source": "muni",
"webUrl": "https://pocasi.seznam.cz/praha"
}
},
"startdate": "2026-10-30"
}
},
{
"type": "organic",
"rank": 2,
"position": 1,
"url": "https://www.in-pocasi.cz/predpoved-pocasi/cz/praha/praha-324/",
"title": "Počasí - Praha, předpověď na 10 dní | In-počasí",
"snippet": "Dlouhodobá předpověď počasí na 10 dní pro město Praha - Česká republik…",
"displayUrl": "https://in-pocasi.cz/predpoved-pocasi/cz/praha/praha-324",
"date": "2011-01-12T23:00:00.000Z",
"ext": {
"docId": "feda8eb0555173f1",
"attributes": {
"isPorn": false,
"language": "CS",
"fileType": "HTML",
"isHomepage": false,
"tags": ["INFORMATIVE"]
},
"favicons": [{"url": "https://fimg-resp.seznam.cz/thumbnail/v1.0/favicon16x16/https%3A%2F%2F…", "size": 16}]
}
},
{"type": "relatedSearches", "rank": 7, "queries": ["počasí praha dlouhodobá předpověď"]}
],
"cursor": "X7gjH7nzLMwqljudpX3DCyEjprC6SOzS7CQl3xzRSrhPof536F88YnXxWRRT1scIcPe-Zy…"
}
}Errors
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_CURSOR | The cursor is not one this operation returned. Start again without it. |
| 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, plus $0.0012 for each extra call it makes — at most 4 more, so $0.006 in total. List price; the rate steps down above 1,000 calls a day.