Yandex SERP API parameters
GET https://serp.shifter.io/v1?engine=yandex&api_key=YOUR_API_KEY&q=<query>
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | yes | Your SERP API key |
engine | string | yes | Must be yandex |
q | string | yes | Search query |
lr | integer | no | Yandex location code (see below) |
lang | ISO code | no | Result language (ru, en, tr, uk) |
p | integer | no | Page number, 0-indexed |
device | desktop | mobile | no | Simulated device |
within | integer | no | Recency filter (days) |
Common lr codes
Section titled “Common lr codes”lr | City / region |
|---|---|
| 1 | Moscow |
| 213 | Moscow region |
| 2 | St. Petersburg |
| 11316 | Novosibirsk |
| 54 | Yekaterinburg |
| 43 | Kazan |
| 47 | Nizhny Novgorod |
| 65 | Samara |
| 66 | Chelyabinsk |
| 55 | Rostov-on-Don |
For the full catalog across all Yandex regions, call engine=yandex_locations or refer to Yandex’s public lr reference.
Examples
Section titled “Examples”Russian search in Moscow:
curl "https://serp.shifter.io/v1?engine=yandex&api_key=YOUR_API_KEY&q=ресторан&lr=1&lang=ru"Turkish search on mobile:
curl "https://serp.shifter.io/v1?engine=yandex&api_key=YOUR_API_KEY&q=yemek&lang=tr&device=mobile"