Yandex API: Search the web

Search Yandex web results with titles, destination URLs, snippets, breadcrumbs, sitelinks, and advertising flags. Pages range from 0 to 24.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

What to search the web for.

Length1 <= length <= 400

page?|

Zero-based page, 10 results each, up to page 24. Deeper pages are slower and more likely to return a retryable 503.

Range0 <= value <= 24

Default0

region_id?integer

Yandex region id (lr) — 213 Moscow, 84 USA. Changes which results come back and how many adverts sit above them; it does not translate them.

Range1 <= value

curl -X GET "https://example.com/v1/yandex/search?query=stripe+payments" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "string",    "region_id": 0,    "page": 0,    "max_page": 0,    "page_exists": true,    "count": 0,    "organic_count": 0,    "advert_count": 0,    "results_found_text": "string",    "results": [      {        "position": 0,        "is_advert": true,        "title": "string",        "url": "string",        "displayed_path": "string",        "snippet": "string",        "sitelinks": [          {            "title": "string",            "url": "string"          }        ]      }    ],    "usage_note": "string"  }}