Seznam Search API

GET | POST /v1/seznam/search

参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。

请求

curl -G "https://gateway.apinoa.com/v1/seznam/search" \
  --data-urlencode "q=počasí praha" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数	类型	说明
`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`

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 ResultsPage。真实响应的节选：数组只保留前几项，长文本已截断。

{
  "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…"
  }
}

错误

状态	代码	含义
400	`INVALID_CURSOR`	该 `cursor` 不是本操作返回的。请不带它重新开始。
400	`INVALID_PARAMS`	参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。
401	`UNAUTHORIZED`	缺少 `x-api-key` 请求头，或密钥已吊销或未知。
402	`INSUFFICIENT_BALANCE`	余额不足以支付本次调用。请在控制台充值。
429	`MARKETPLACE_SATURATED`	并发调用过多。请等待 `Retry-After` 秒后重试。
502	`UPSTREAM_ERROR`	引擎返回了无法使用的内容。请退避后重试。
503	`SERVICE_UNAVAILABLE`	临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格每次调用 $0.0012，每多一次调用加 $0.0012——最多再加 4 次，合计最多 $0.006。标价；单日调用超过 1,000 次后单价下调。

Search

请求

参数

响应

错误

价格

本页内容