# Yandex (Яндекс) | Парсер Поиска Яндекса (`johnvc/scrape-yandex`) Actor

Яндекс Apify Actor specifically designed for Yandex search scraping. Supports 6+ domains, 19 languages, and provides clean, structured data extraction with intelligent pagination. Парсер поиска Яндекса: органика, реклама, граф знаний, изображения и видео. Для SEO, аналитики и исследований рынка.

- **URL**: https://apify.com/johnvc/scrape-yandex.md
- **Developed by:** [John](https://apify.com/johnvc) (community)
- **Categories:** SEO tools, Developer tools, Other
- **Stats:** 1,920 total users, 37 monthly users, 99.8% runs succeeded, 14 bookmarks
- **User rating**: 4.43 out of 5 stars

## Pricing

from $0.01 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## 🚀 Yandex Search Scraper 🇷🇺🇺🇸 | Парсер Поиска Яндекса

Scrape Yandex Search Engine Results Pages (SERPs) at scale. Extract organic results, ads, knowledge graph entries, inline images, and inline videos, across 6 Yandex domains, 19 languages, and 123,000+ geographic locations.

Парсер поиска Яндекса для работы в больших объёмах. Извлекайте органическую выдачу, рекламу, карточки графа знаний, блоки изображений и видео по 6 доменам Яндекса, 19 языкам и более чем 123 000 регионам.

This is the Pay Per Event Edition. If you're looking for the Pay Per Result Edition, see [ApifyYandex-PayPerRun](https://apify.com/johnvc/yandex-scrape-yandex-search-results-at-scale---per-result#apify-yandex-search-scraper-pay-per-result-edition?fpr=9n7kx3&fp_sid=roastmya)

Это редакция с оплатой за событие (Pay Per Event). Если вам нужна редакция с оплатой за результат (Pay Per Result), смотрите [ApifyYandex-PayPerRun](https://apify.com/johnvc/yandex-scrape-yandex-search-results-at-scale---per-result#apify-yandex-search-scraper-pay-per-result-edition?fpr=9n7kx3&fp_sid=roastmya)

See our [quick and easy getting started guide to scraping Yandex Search on GitHub here](https://github.com/johnisanerd/Apify-Yandex-Search-Scraper)

Смотрите наше [простое руководство по началу работы с парсингом поиска Яндекса на GitHub](https://github.com/johnisanerd/Apify-Yandex-Search-Scraper)

### 📦 What Data Does This Actor Return? | Какие данные возвращает этот актор?

This actor extracts five Yandex result types. Pick exactly the ones you want with the à la carte toggles (see below) - organic results are on by default, the rest are opt-in.

- **Organic results** - the standard ranked links, present on every search. Each carries position, title, URL, displayed link, snippet, date, thumbnail, favicon, rich snippet, and sitelinks.
- **Ads** - paid placements that appear on commercial queries (above or below the organic block). Each carries position, title, URL, displayed link, snippet, and sitelinks.
- **Knowledge graph** - the entity card Yandex shows for people, TV shows, places, companies, and other known entities. Carries title, description, type, image, source, and entity attributes (cast, genre, country, founding info, see-also links).
- **Inline images** - the image strip that can appear between organic results. Each image carries title, image URL, and thumbnail.
- **Inline videos** - the video carousel that can appear between organic results. Each carries title, link, source, duration, thumbnail, views, and date.
- **Search metadata** - on every item: domain, language, location, page number, sort mode, time period, and pagination info.

#### 🎚️ Choose your result types (à la carte) | Выбор типов результатов

Toggle each result type independently: **Organic results** (on by default), **Ads**, **Knowledge graph**, **Inline images**, **Inline videos**. Each selected type that appears on a page is delivered as its own dataset item, tagged with an `item_type` field so you can tell them apart. If none of your selected types appear (for example you enabled only Ads and the query has no ads), the actor returns a single summary item noting that no results were found for your selection, so the run is never silently empty. The page limit applies to every selected type together. Two optional SERP-wide filters are available: **Sort mode** (`relevance` or `date`) and **Time period** (`all`, `day`, `last_two_weeks`, `month`).

Каждый тип результатов включается отдельно: **органическая выдача** (включена по умолчанию), **реклама**, **граф знаний**, **встроенные изображения**, **встроенные видео**. Каждый выбранный тип, присутствующий на странице, сохраняется как отдельный элемент набора данных с полем `item_type`. Лимит страниц применяется ко всем выбранным типам вместе. Доступны два необязательных фильтра: **сортировка** (`relevance` или `date`) и **период** (`all`, `day`, `last_two_weeks`, `month`).

### 🎯 Use Cases | Сценарии использования

- **SEO research for Russian-speaking markets** - track keyword rankings across Yandex.ru, Yandex.by, Yandex.kz, and other CIS domains
- **Competitive intelligence** - monitor competitor visibility in Yandex search across different regions and languages
- **Brand monitoring** - track brand mentions and reputation across Yandex domains in Eastern Europe and Central Asia
- **Academic and market research** - gather structured SERP data for analysis without manual searching
- **Lead generation** - surface businesses, directories, and contact pages from Yandex organic results
- **Content gap analysis** - identify what content ranks in Yandex that doesn't rank on Western search engines

- **SEO-исследования для русскоязычных рынков** - отслеживайте позиции по ключевым словам в Yandex.ru, Yandex.by, Yandex.kz и других доменах СНГ
- **Конкурентная разведка** - отслеживайте видимость конкурентов в поиске Яндекса по разным регионам и языкам
- **Мониторинг бренда** - отслеживайте упоминания бренда и репутацию по доменам Яндекса в Восточной Европе и Центральной Азии
- **Академические и рыночные исследования** - собирайте структурированные данные выдачи для анализа без ручного поиска
- **Генерация лидов** - находите компании, каталоги и контактные страницы в органической выдаче Яндекса
- **Анализ пробелов в контенте** - выявляйте контент, который ранжируется в Яндексе, но не ранжируется в западных поисковиках

### 🌟 Why Choose This Scraper? | Почему стоит выбрать этот скрапер?

#### "In Soviet Russia, Yandex website scrape you!" 🇷🇺🇺🇸

The Yandex Search data scraper delivers enterprise-grade performance with these advanced capabilities:

**Performance & Reliability**: Built optimized for high-throughput scraping with intelligent rate limiting and pagination handling.

**Cost-Effective**: Provides consistent, reliable results with intelligent pagination management to optimize API usage.

**Lightning-Fast Search & Retrieval**: Search any keyword across Yandex with fast performance. Retrieve comprehensive results in seconds, not minutes, with intelligent caching and optimization.

**Precision Targeting & Advanced Filtering**: Pinpoint exact search parameters with domain-specific localization, language support, and location targeting. Get precisely the search data you need, when you need it.

**Rich, Structured Data Extraction**: Extract complete search information, including organic results, ads, knowledge graph, inline images, and inline videos. Our advanced parsing ensures you get clean, structured data ready for immediate use.

**Enterprise-Grade Configuration & Flexibility**: Built for developers and businesses who demand reliability. Highly configurable with intuitive controls, comprehensive error handling, and robust logging.

**No Hidden Costs or Rental Fees**: We do not charge monthly rentals. Our scraper operates on a pay-per-use model. Scale up or down based on your actual needs without being locked into expensive subscriptions.

Скрапер данных поиска Яндекса обеспечивает производительность корпоративного уровня и следующие продвинутые возможности:

**Производительность и надёжность**: оптимизирован для высокопроизводительного парсинга с разумным ограничением частоты запросов и обработкой постраничной навигации.

**Экономичность**: даёт стабильные и надёжные результаты с разумным управлением пагинацией для оптимизации использования API.

**Молниеносный поиск и получение данных**: ищите любое ключевое слово в Яндексе с высокой скоростью. Получайте полные результаты за секунды, а не минуты, благодаря кэшированию и оптимизации.

**Точный таргетинг и продвинутая фильтрация**: задавайте точные параметры поиска с локализацией по доменам, поддержкой языков и таргетингом по локациям. Получайте именно те данные, которые вам нужны.

**Извлечение богатых структурированных данных**: извлекайте полную информацию из выдачи, включая органические результаты, рекламу, граф знаний, встроенные изображения и видео. Продвинутый разбор гарантирует чистые структурированные данные, готовые к использованию.

**Гибкая настройка корпоративного уровня**: создан для разработчиков и компаний, которым нужна надёжность. Широкие возможности настройки с понятным управлением, обработкой ошибок и подробным логированием.

**Без скрытых платежей и абонентской платы**: мы не берём ежемесячную аренду. Скрапер работает по модели оплаты за использование. Масштабируйтесь вверх или вниз по реальным потребностям без дорогих подписок.

### 🚀 Features | Возможности

#### Core Capabilities
- **Advanced Search**: Support for complex queries with domain-specific localization and language targeting
- **Intelligent Pagination**: Automatic handling of Yandex search pagination with configurable limits
- **Global Localization**: Support for 15+ Yandex domains across different regions
- **Language Support**: 19 officially supported languages including Russian, English, Turkish, and more
- **Location Targeting**: Custom location/region ID support for precise geographic targeting

#### Data Quality
- **Clean Output**: Automatic structured data metadata for clean, production-ready data
- **Structured Results**: Consistent JSON structure across all search results
- **Comprehensive Fields**: Organic results, ads, knowledge graph, news, inline images, inline videos, and related searches
- **Metadata Tracking**: Page-level analytics and search performance metrics
- **Per-Page Billing**: Results are pushed as separate dataset items for accurate billing

#### Основные возможности
- **Продвинутый поиск**: поддержка сложных запросов с локализацией по доменам и таргетингом по языку
- **Умная пагинация**: автоматическая обработка постраничной навигации Яндекса с настраиваемыми лимитами
- **Глобальная локализация**: поддержка более 15 доменов Яндекса в разных регионах
- **Поддержка языков**: 19 официально поддерживаемых языков, включая русский, английский, турецкий и другие
- **Таргетинг по локации**: поддержка произвольного идентификатора региона для точного географического таргетинга

#### Качество данных
- **Чистый вывод**: автоматические структурированные метаданные для готовых к работе данных
- **Структурированные результаты**: единообразная структура JSON для всех результатов
- **Полный набор полей**: органика, реклама, граф знаний, новости, встроенные изображения и видео, связанные запросы
- **Метаданные**: аналитика на уровне страницы и метрики эффективности поиска
- **Оплата за страницу**: результаты сохраняются как отдельные элементы набора данных для точного учёта

### 📖 Usage Examples | Примеры использования

#### Basic Search Example | Базовый пример

Search for "python tutorial" with default settings. | Поиск "python tutorial" с настройками по умолчанию.

```json
{
  "text": "python tutorial"
}
````

#### Advanced Search Example 1 | Расширенный пример 1

Search for "machine learning" with Russian domain, Russian language, and pagination limits. | Поиск "machine learning" с российским доменом, русским языком и лимитом страниц.

```json
{
  "text": "machine learning",
  "yandex_domain": "yandex.ru",
  "lang": "ru",
  "max_pages": 3
}
```

#### Advanced Search Example 2 | Расширенный пример 2

Search for "машинное обучение" on the Russian domain, in Russian, localized to Moscow. | Поиск "машинное обучение" на российском домене, на русском языке, с локализацией по Москве.

```json
{
  "text": "машинное обучение",
  "yandex_domain": "yandex.ru",
  "lang": "ru",
  "lr": 213,
  "max_pages": 1
}
```

#### Advanced Search Example 3 | Расширенный пример 3

Search for "yandex scrapers" with English domain, English language, and location targeting. | Поиск "yandex scrapers" с английским доменом, английским языком и таргетингом по локации.

```json
{
  "text": "yandex scrapers",
  "yandex_domain": "yandex.com",
  "lang": "en",
  "lr": 84,
  "max_pages": 2
}
```

#### 💡 Tip: Filter Results by Date | Совет: фильтрация по дате

Yandex supports a native date range operator directly in the search query. Append `date:YYYYMMDD..YYYYMMDD` to your search text to limit results to a specific time window.

Яндекс поддерживает встроенный оператор диапазона дат прямо в поисковом запросе. Добавьте `date:YYYYMMDD..YYYYMMDD` к тексту запроса, чтобы ограничить результаты определённым периодом.

**Filter results from the last 30 days | Результаты за последние 30 дней:**

```json
{
  "text": "climate news date:20260317..20260417",
  "yandex_domain": "yandex.com",
  "lang": "en",
  "max_pages": 1
}
```

**Filter results from a specific year | Результаты за конкретный год:**

```json
{
  "text": "machine learning date:20250101..20251231",
  "yandex_domain": "yandex.ru",
  "lang": "ru",
  "max_pages": 2
}
```

| Syntax / Синтаксис | Example / Пример | Description / Описание |
|--------|---------|-------------|
| `date:YYYYMMDD..YYYYMMDD` | `date:20260101..20260417` | Results published between two dates / Результаты между двумя датами |
| `date:YYYYMMDD..` | `date:20260101..` | Results published after a date / Результаты после даты |
| `date:..YYYYMMDD` | `date:..20260101` | Results published before a date / Результаты до даты |

The date filter is part of the `text` field, no additional parameters needed. | Фильтр по дате является частью поля `text` и не требует дополнительных параметров.

***

### 🔍 Input References | Входные параметры

##### Input Parameters | Входные параметры

| Parameter | Type | Required | Default | Description / Описание |
|-----------|------|----------|---------|-------------|
| `text` | `str` | ✅ | `"python tutorial"` | Search query / Поисковый запрос |
| `include_organic_results` | `bool` | ❌ | `true` | Return organic results (item\_type `organic`) / Возвращать органическую выдачу |
| `include_ads` | `bool` | ❌ | `false` | Return paid ads when present (item\_type `ads`) / Возвращать рекламу |
| `include_knowledge_graph` | `bool` | ❌ | `false` | Return the knowledge graph card when present (item\_type `knowledge_graph`) / Возвращать граф знаний |
| `include_inline_images` | `bool` | ❌ | `false` | Return the inline image strip (item\_type `inline_images`) / Возвращать блок изображений |
| `include_inline_videos` | `bool` | ❌ | `false` | Return the inline video carousel (item\_type `inline_videos`) / Возвращать блок видео |
| `yandex_domain` | `str` | ❌ | `"yandex.com"` | Yandex domain (e.g., `"yandex.ru"` for Russia, `"yandex.com.tr"` for Turkey) / Домен Яндекса |
| `lang` | `str` | ❌ | `"en"` | Language code (e.g., `"ru"`, `"tr"`, `"null"` for unspecified) / Код языка |
| `lr` | `int` | ❌ | `None` | Location/region ID to limit results to a country, region, or city. Defaults to the domain default (e.g., `84` for `yandex.com`, `225` for `yandex.ru`). See the Location IDs table below. / Идентификатор региона для ограничения выдачи по стране, региону или городу. Смотрите таблицу регионов ниже. |
| `max_pages` | `int` | ❌ | `2` | Maximum pages to fetch (0 = no limit). Applies to every selected result type. / Максимум страниц (0 = без лимита) |
| `groups_on_page` | `int` | ❌ | `10` | Number of result groups per page (1-20) / Число групп результатов на странице (1-20) |
| `family_mode` | `int` | ❌ | `1` | Safe search: `0` = off, `1` = moderate, `2` = strict / Безопасный поиск |
| `fix_typo` | `bool` | ❌ | `true` | Auto-correct spelling errors in the query / Автоисправление опечаток в запросе |
| `sort_mode` | `str` | ❌ | `"relevance"` | Result ordering: `"relevance"` or `"date"` / Сортировка результатов |
| `period` | `str` | ❌ | `"all"` | Recency window: `"all"`, `"day"`, `"last_two_weeks"`, `"month"` / Период по времени |
| `output_file` | `str` | ❌ | `None` | Custom output filename / Имя файла для вывода |

***

### 📍 Yandex Location IDs (`lr`) | Идентификаторы регионов Яндекса (`lr`)

The `lr` parameter controls which geographic region Yandex uses to localize search results. Each Yandex domain has a default `lr` value, but you can override it with any value from the table below.

Параметр `lr` определяет, какой географический регион Яндекс использует для локализации результатов. У каждого домена есть значение `lr` по умолчанию, но его можно переопределить любым значением из таблицы ниже.

**Default `lr` by domain | Значение `lr` по умолчанию для каждого домена:**

| Domain | Default lr | Region / Регион |
|--------|-----------|--------|
| `yandex.com` | `84` | United States / США |
| `yandex.ru` | `225` | Russia / Россия |
| `yandex.by` | `149` | Belarus / Беларусь |
| `yandex.kz` | `159` | Kazakhstan / Казахстан |
| `yandex.uz` | `171` | Uzbekistan / Узбекистан |
| `yandex.com.tr` | - | Turkey / Турция |

**Retired Yandex domains | Закрытые домены Яндекса**

Yandex consolidated its regional portals: the domains below no longer serve search results, and the actor rejects them. To target those countries, use a supported domain with the `lr` and `lang` parameters instead. | Яндекс закрыл свои региональные порталы: домены ниже больше не возвращают результаты поиска. Для таргетинга на эти страны используйте поддерживаемый домен с параметрами `lr` и `lang`.

| Retired domain / Закрытый домен | Use instead / Используйте вместо |
|----------------|----------------------------------|
| `ya.ru` | `yandex.ru` |
| `yandex.az` | `yandex.com` + `lr=167` + `lang=az` |
| `yandex.com.ge` | `yandex.com` + `lr=169` |
| `yandex.com.am` | `yandex.com` + `lr=168` + `lang=hy` |
| `yandex.co.il` | `yandex.com` + `lr=181` |
| `yandex.md` | `yandex.com` + `lr=208` + `lang=ro` |
| `yandex.tm` | `yandex.com` + `lr=170` + `lang=tk` |
| `yandex.tj` | `yandex.com` + `lr=209` |
| `yandex.eu` | `yandex.com` + `lr=111` |

**Common location IDs** (full list of 123,000+ locations is available in `yandex-ru-geo-codes.json`). | **Часто используемые идентификаторы** (полный список из более чем 123 000 локаций доступен в `yandex-ru-geo-codes.json`).

#### Global / Continental | Мир и континенты

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 10000 | Earth | Земля |
| 10001 | Eurasia | Евразия |
| 10002 | North America | Северная Америка |
| 111 | Europe | Европа |
| 183 | Asia | Азия |
| 138 | Australia and Oceania | Австралия и Океания |
| 241 | Africa | Африка |
| 166 | CIS | СНГ |

#### Russia | Россия

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 225 | Russia | Россия |
| 1 | Moscow and Moscow Oblast | Москва и Московская область |
| 213 | Moscow | Москва |
| 2 | Saint Petersburg | Санкт-Петербург |
| 3 | Central Federal District | Центральный федеральный округ |
| 17 | Northwestern Federal District | Северо-Западный федеральный округ |
| 26 | Southern Federal District | Южный федеральный округ |
| 40 | Volga Federal District | Приволжский федеральный округ |
| 52 | Ural Federal District | Уральский федеральный округ |
| 59 | Siberian Federal District | Сибирский федеральный округ |
| 73 | Far Eastern Federal District | Дальневосточный федеральный округ |
| 4 | Belgorod | Белгород |
| 35 | Krasnodar | Краснодар |
| 39 | Rostov-na-Donu | Ростов-на-Дону |
| 43 | Kazan | Казань |
| 47 | Nizhny Novgorod | Нижний Новгород |
| 50 | Perm | Пермь |
| 51 | Samara | Самара |
| 54 | Yekaterinburg | Екатеринбург |
| 62 | Krasnoyarsk | Красноярск |
| 63 | Irkutsk | Иркутск |
| 65 | Novosibirsk | Новосибирск |
| 66 | Omsk | Омск |
| 172 | Ufa | Уфа |
| 239 | Sochi | Сочи |
| 240 | Togliatti | Тольятти |
| 235 | Magnitogorsk | Магнитогорск |
| 237 | Novokuznetsk | Новокузнецк |

#### Former Soviet States / CIS | Постсоветские государства и СНГ

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 149 | Belarus | Беларусь |
| 157 | Minsk | Минск |
| 153 | Brest | Брест |
| 155 | Gomel | Гомель |
| 159 | Kazakhstan | Казахстан |
| 162 | Almaty | Алматы |
| 163 | Astana | Астана |
| 164 | Karaganda | Караганда |
| 190 | Pavlodar | Павлодар |
| 221 | Chimkent | Шымкент |
| 167 | Azerbaijan | Азербайджан |
| 168 | Armenia | Армения |
| 169 | Georgia | Грузия |
| 170 | Turkmenistan | Туркменистан |
| 171 | Uzbekistan | Узбекистан |
| 207 | Kyrgyzstan | Кыргызстан |
| 208 | Moldova | Молдова |
| 209 | Tajikistan | Таджикистан |
| 187 | Ukraine | Украина |
| 143 | Kyiv | Киев |
| 141 | Dnipro | Днепр |
| 144 | Lviv | Львов |
| 145 | Odesa | Одесса |
| 147 | Kharkiv | Харьков |

#### Middle East & Asia | Ближний Восток и Азия

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 181 | Israel | Израиль |
| 129 | Beer-Sheva | Беэр-Шева |
| 130 | Jerusalem | Иерусалим |
| 131 | Tel Aviv | Тель-Авив |
| 132 | Haifa | Хайфа |
| 210 | United Arab Emirates | Объединённые Арабские Эмираты |
| 134 | China | Китай |
| 135 | South Korea | Южная Корея |
| 137 | Japan | Япония |

#### Europe | Европа

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 96 | Germany | Германия |
| 177 | Berlin | Берлин |
| 178 | Hamburg | Гамбург |
| 100 | Frankfurt am Main | Франкфурт-на-Майне |
| 99 | Munich | Мюнхен |
| 102 | United Kingdom | Великобритания |
| 124 | France | Франция |
| 204 | Spain | Испания |
| 205 | Italy | Италия |
| 246 | Greece | Греция |
| 113 | Austria | Австрия |
| 114 | Belgium | Бельгия |
| 115 | Bulgaria | Болгария |
| 116 | Hungary | Венгрия |
| 117 | Lithuania | Литва |
| 118 | Netherlands | Нидерланды |
| 119 | Norway | Норвегия |
| 120 | Poland | Польша |
| 123 | Finland | Финляндия |
| 125 | Czech Republic | Чехия |
| 126 | Switzerland | Швейцария |
| 127 | Sweden | Швеция |
| 203 | Denmark | Дания |
| 206 | Latvia | Латвия |
| 179 | Estonia | Эстония |
| 180 | Serbia | Сербия |

#### Americas | Америка

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 84 | United States | США |
| 87 | Washington | Вашингтон |
| 200 | Los Angeles | Лос-Анджелес |
| 202 | New York | Нью-Йорк |
| 223 | Boston | Бостон |
| 86 | Atlanta | Атланта |
| 90 | San Francisco | Сан-Франциско |
| 91 | Seattle | Сиэтл |
| 89 | Detroit | Детройт |
| 95 | Canada | Канада |
| 93 | Argentina | Аргентина |
| 94 | Brazil | Бразилия |

#### Oceania | Океания

| lr | English Name | Russian Name |
|----|-------------|-------------|
| 211 | Australia | Австралия |
| 139 | New Zealand | Новая Зеландия |

### 📊 Output Format | Формат вывода

#### Search Result Structure | Структура результата

```json
{
  "text": "machine learning",
  "yandex_domain": "yandex.ru",
  "lang": "ru",
  "lr": "225",
  "max_pages": 3,
  "total_results_found": 150,
  "pages_processed": 3,
  "search_metadata": {
    "yandex_domain": "yandex.ru",
    "domain_description": "Russia",
    "language": "ru",
    "language_description": "Russian",
    "location": "225",
    "max_pages": 3,
    "pagination_limit_reached": false
  },
  "pagination_info": {
    "total_pages": 3,
    "max_pages_set": 3,
    "pagination_stopped_by_limit": false,
    "results_per_page": 10
  },
  "organic_results": [
    {
      "title": "Machine Learning Tutorial",
      "link": "https://example.com/ml-tutorial",
      "snippet": "Learn machine learning fundamentals...",
      "position": 1,
      "displayed_link": "example.com",
      "thumbnail": "https://thumbnail.url",
      "favicon": "https://favicon.url",
      "date": "2024-01-15",
      "rich_snippet": "Rich snippet content...",
      "sitelinks": [...]
    }
  ],
  "ads_results": [...],
  "knowledge_graph": [...],
  "inline_images": [...],
  "inline_videos": [...],
  "results_by_page": {
    "1": {
      "organic_results": [...],
      "ads_results": [...],
      "knowledge_graph": [...],
      "inline_images": [...],
      "inline_videos": [...]
    }
  }
}
```

**Made with ❤️ | Сделано с ❤️**

*Transform your search automation with the most reliable and efficient Yandex search scraper on the market.*

*Выведите автоматизацию поиска на новый уровень с самым надёжным и эффективным парсером поиска Яндекса.*

***

### Featured Tasks

Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can
run it on your account in one click.

- [Check Yandex keyword rankings in Moscow](https://apify.com/johnvc/Scrape-Yandex/examples/check-yandex-keyword-rankings-in-moscow?fpr=9n7kx3) - track who ranks on Yandex for your keywords in Moscow with positions and snippets.
- [Get Yandex search results without an API key](https://apify.com/johnvc/Scrape-Yandex/examples/get-yandex-search-results-without-an-api-key?fpr=9n7kx3) - organic Yandex results as clean JSON with no key or quota setup.
- [Use Yandex search in Claude via MCP](https://apify.com/johnvc/Scrape-Yandex/examples/use-yandex-search-in-claude-via-mcp?fpr=9n7kx3) - let Claude search the Russian web live inside the conversation (free trial available).

***

- [Check SERP results in Russian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-russian-on-yandex?fpr=9n7kx3) - run a Russian query on yandex.ru and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Russian search..
- [Check SERP results in English on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-english-on-yandex?fpr=9n7kx3) - run an English query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for English search..
- [Check SERP results in Belarusian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-belarusian-on-yandex?fpr=9n7kx3) - run a Belarusian query on yandex.by and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Belarusian search..
- [Check SERP results in Ukrainian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-ukrainian-on-yandex?fpr=9n7kx3) - run a Ukrainian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Ukrainian search..
- [Check SERP results in Kazakh on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-kazakh-on-yandex?fpr=9n7kx3) - run a Kazakh query on yandex.kz and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Kazakh search..
- [Check SERP results in Tatar on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-tatar-on-yandex?fpr=9n7kx3) - run a Tatar query on yandex.ru and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Tatar search..
- [Check SERP results in Turkish on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-turkish-on-yandex?fpr=9n7kx3) - run a Turkish query on yandex.com.tr and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Turkish search..
- [Check SERP results in Uzbek on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-uzbek-on-yandex?fpr=9n7kx3) - run an Uzbek query on yandex.uz and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Uzbek search..
- [Check SERP results in French on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-french-on-yandex?fpr=9n7kx3) - run a French query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for French search..
- [Check SERP results in Indonesian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-indonesian-on-yandex?fpr=9n7kx3) - run an Indonesian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language and region set for Indonesian search..
- [Check SERP results in German on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-german-on-yandex?fpr=9n7kx3) - run a German query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to German..
- [Check SERP results in Azerbaijani on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-azerbaijani-on-yandex?fpr=9n7kx3) - run an Azerbaijani query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Azerbaijani..
- [Check SERP results in Armenian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-armenian-on-yandex?fpr=9n7kx3) - run an Armenian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Armenian..
- [Check SERP results in Romanian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-romanian-on-yandex?fpr=9n7kx3) - run a Romanian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Romanian..
- [Check SERP results in Turkmen on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-turkmen-on-yandex?fpr=9n7kx3) - run a Turkmen query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Turkmen..
- [Check SERP results in Latvian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-latvian-on-yandex?fpr=9n7kx3) - run a Latvian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Latvian..
- [Check SERP results in Lithuanian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-lithuanian-on-yandex?fpr=9n7kx3) - run a Lithuanian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Lithuanian..
- [Check SERP results in Estonian on Yandex](https://apify.com/johnvc/Scrape-Yandex/examples/check-serp-results-in-estonian-on-yandex?fpr=9n7kx3) - run an Estonian query on yandex.com and get the SERP as JSON: organic results with titles, links, and snippets, language preset to Estonian..

***

- [Track Yandex Search Ads for a Keyword](https://apify.com/johnvc/Scrape-Yandex/examples/track-yandex-search-ads-for-a-keyword?fpr=9n7kx3) - research paid ads on a Yandex results page: each ad's position, title, link, displayed URL, and snippet as JSON.
- [Extract Yandex Knowledge Graph Entities](https://apify.com/johnvc/Scrape-Yandex/examples/extract-yandex-knowledge-graph-entities?fpr=9n7kx3) - pull the entity card for a brand, person, or topic: title, description, type, source, image, and attributes.
- [Collect Yandex Video Results for a Query](https://apify.com/johnvc/Scrape-Yandex/examples/collect-yandex-video-results-for-a-query?fpr=9n7kx3) - get the inline video carousel for any query: each video's title, link, source, duration, thumbnail, and view count.
- [Collect Yandex Inline Images for a Query](https://apify.com/johnvc/Scrape-Yandex/examples/collect-yandex-inline-images-for-a-query?fpr=9n7kx3) - get the inline image strip for any query: each image's title, thumbnail, and link.
- [Get Recent Yandex Results from the Last Month](https://apify.com/johnvc/Scrape-Yandex/examples/get-recent-yandex-results-from-the-last-month?fpr=9n7kx3) - pull fresh organic results filtered to the last month for freshness-sensitive monitoring.
- [Sort Yandex Search Results by Date](https://apify.com/johnvc/Scrape-Yandex/examples/sort-yandex-search-results-by-date?fpr=9n7kx3) - get organic results ordered by date instead of relevance for news and time-series tracking.

Last Updated: 2026.06.17

# Actor input Schema

## `text` (type: `string`):

The search term to search for on Yandex. You can use anything that you would use in a regular Yandex search.

## `include_organic_results` (type: `boolean`):

Return organic (non-paid) search results. Each page of organic results is delivered as its own dataset item (item\_type 'organic'). Enabled by default.

## `include_ads` (type: `boolean`):

Return paid advertisement results when the query triggers them (typically commercial queries). Delivered as items with item\_type 'ads'. Off by default.

## `include_knowledge_graph` (type: `boolean`):

Return the knowledge graph entity card when present (people, shows, places, brands, etc.). Delivered as items with item\_type 'knowledge\_graph'. Off by default.

## `include_inline_images` (type: `boolean`):

Return the inline image strip that can appear between organic results. Delivered as items with item\_type 'inline\_images'. Off by default.

## `include_inline_videos` (type: `boolean`):

Return the inline video carousel that can appear between organic results. Delivered as items with item\_type 'inline\_videos'. Off by default.

## `yandex_domain` (type: `string`):

The Yandex domain to use for search results. Defaults to 'yandex.com'. Each domain has default language and location settings. Yandex retired its other regional portals (ya.ru search, yandex.az, yandex.com.am, yandex.com.ge, yandex.co.il, yandex.md, yandex.tm, yandex.tj, yandex.eu) - to target those countries, combine a supported domain with the 'lang' and 'lr' parameters.

## `lang` (type: `string`):

Language code for search results. Set to null for 'Unspecified'. Can use comma-separated values for multi-language (e.g., 'ru,en'). Defaults to domain language if not specified.

## `lr` (type: `integer`):

Country or region ID to limit search results to a specific geographic location. If not set, the default location for the selected yandex\_domain is used (e.g., 84 for yandex.com, 225 for yandex.ru). Common values: 225=Russia, 84=United States, 149=Belarus, 159=Kazakhstan, 171=Uzbekistan, 167=Azerbaijan, 168=Armenia, 169=Georgia, 181=Israel, 208=Moldova, 170=Turkmenistan, 209=Tajikistan, 111=Europe. See the actor README for a full location reference table.

## `max_pages` (type: `integer`):

Maximum number of pages to fetch (0 = no limit, default: 2 to avoid too many requests).

## `groups_on_page` (type: `integer`):

Maximum number of search result groups (listings) returned per page. Accepts values between 1 and 20. Default is 10.

## `family_mode` (type: `integer`):

Controls safe search filtering. 0 = off (no filtering), 1 = moderate (default), 2 = strict (filter explicit content).

## `fix_typo` (type: `boolean`):

Automatically correct spelling errors in the search query. Default is true.

## `sort_mode` (type: `string`):

How Yandex orders the results. 'relevance' (default) ranks by relevance; 'date' ranks newest first. Applies to all selected result types.

## `period` (type: `string`):

Restrict results to a recency window. 'all' (default) = no time limit; 'day' = last 24 hours; 'last\_two\_weeks' = last 14 days; 'month' = last 30 days. Applies to all selected result types.

## `output_file` (type: `string`):

Optional filename to save results. If not provided, will auto-generate based on search text and parameters.

## Actor input object example

```json
{
  "text": "python tutorial",
  "include_organic_results": true,
  "include_ads": false,
  "include_knowledge_graph": false,
  "include_inline_images": false,
  "include_inline_videos": false,
  "yandex_domain": "yandex.com",
  "lang": "en",
  "max_pages": 2,
  "groups_on_page": 10,
  "family_mode": 1,
  "fix_typo": true,
  "sort_mode": "relevance",
  "period": "all"
}
```

# Actor output Schema

## `allResults` (type: `string`):

Complete dataset with all search results including organic results, ads, knowledge graph, and media

## `organicResults` (type: `string`):

Organic search results from Yandex

## `knowledgeGraph` (type: `string`):

Knowledge graph information about the search query

## `summary` (type: `string`):

Summary information including search metadata and pagination info

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "text": "python tutorial",
    "lang": "en"
};

// Run the Actor and wait for it to finish
const run = await client.actor("johnvc/scrape-yandex").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "text": "python tutorial",
    "lang": "en",
}

# Run the Actor and wait for it to finish
run = client.actor("johnvc/scrape-yandex").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "text": "python tutorial",
  "lang": "en"
}' |
apify call johnvc/scrape-yandex --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=johnvc/scrape-yandex",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Yandex (Яндекс) | Парсер Поиска Яндекса",
        "description": "Яндекс Apify Actor specifically designed for Yandex search scraping. Supports 6+ domains, 19 languages, and provides clean, structured data extraction with intelligent pagination. Парсер поиска Яндекса: органика, реклама, граф знаний, изображения и видео. Для SEO, аналитики и исследований рынка.",
        "version": "0.0",
        "x-build-id": "EZXVD4hmLA6kKY5Ll"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/johnvc~scrape-yandex/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-johnvc-scrape-yandex",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/johnvc~scrape-yandex/runs": {
            "post": {
                "operationId": "runs-sync-johnvc-scrape-yandex",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/johnvc~scrape-yandex/run-sync": {
            "post": {
                "operationId": "run-sync-johnvc-scrape-yandex",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "text"
                ],
                "properties": {
                    "text": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "The search term to search for on Yandex. You can use anything that you would use in a regular Yandex search."
                    },
                    "include_organic_results": {
                        "title": "Organic results",
                        "type": "boolean",
                        "description": "Return organic (non-paid) search results. Each page of organic results is delivered as its own dataset item (item_type 'organic'). Enabled by default.",
                        "default": true
                    },
                    "include_ads": {
                        "title": "Ads",
                        "type": "boolean",
                        "description": "Return paid advertisement results when the query triggers them (typically commercial queries). Delivered as items with item_type 'ads'. Off by default.",
                        "default": false
                    },
                    "include_knowledge_graph": {
                        "title": "Knowledge graph",
                        "type": "boolean",
                        "description": "Return the knowledge graph entity card when present (people, shows, places, brands, etc.). Delivered as items with item_type 'knowledge_graph'. Off by default.",
                        "default": false
                    },
                    "include_inline_images": {
                        "title": "Inline images",
                        "type": "boolean",
                        "description": "Return the inline image strip that can appear between organic results. Delivered as items with item_type 'inline_images'. Off by default.",
                        "default": false
                    },
                    "include_inline_videos": {
                        "title": "Inline videos",
                        "type": "boolean",
                        "description": "Return the inline video carousel that can appear between organic results. Delivered as items with item_type 'inline_videos'. Off by default.",
                        "default": false
                    },
                    "yandex_domain": {
                        "title": "Yandex Domain",
                        "enum": [
                            "yandex.com",
                            "yandex.ru",
                            "yandex.by",
                            "yandex.kz",
                            "yandex.uz",
                            "yandex.com.tr"
                        ],
                        "type": "string",
                        "description": "The Yandex domain to use for search results. Defaults to 'yandex.com'. Each domain has default language and location settings. Yandex retired its other regional portals (ya.ru search, yandex.az, yandex.com.am, yandex.com.ge, yandex.co.il, yandex.md, yandex.tm, yandex.tj, yandex.eu) - to target those countries, combine a supported domain with the 'lang' and 'lr' parameters.",
                        "default": "yandex.com"
                    },
                    "lang": {
                        "title": "Language",
                        "enum": [
                            "null",
                            "ru",
                            "en",
                            "be",
                            "fr",
                            "de",
                            "id",
                            "kk",
                            "tt",
                            "tr",
                            "uk",
                            "uz",
                            "az",
                            "hy",
                            "lv",
                            "lt",
                            "et",
                            "ro",
                            "tk"
                        ],
                        "type": "string",
                        "description": "Language code for search results. Set to null for 'Unspecified'. Can use comma-separated values for multi-language (e.g., 'ru,en'). Defaults to domain language if not specified."
                    },
                    "lr": {
                        "title": "Location/Region ID (lr)",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Country or region ID to limit search results to a specific geographic location. If not set, the default location for the selected yandex_domain is used (e.g., 84 for yandex.com, 225 for yandex.ru). Common values: 225=Russia, 84=United States, 149=Belarus, 159=Kazakhstan, 171=Uzbekistan, 167=Azerbaijan, 168=Armenia, 169=Georgia, 181=Israel, 208=Moldova, 170=Turkmenistan, 209=Tajikistan, 111=Europe. See the actor README for a full location reference table."
                    },
                    "max_pages": {
                        "title": "Maximum Pages",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of pages to fetch (0 = no limit, default: 2 to avoid too many requests).",
                        "default": 2
                    },
                    "groups_on_page": {
                        "title": "Results per Page",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "Maximum number of search result groups (listings) returned per page. Accepts values between 1 and 20. Default is 10.",
                        "default": 10
                    },
                    "family_mode": {
                        "title": "Safe Search",
                        "minimum": 0,
                        "maximum": 2,
                        "type": "integer",
                        "description": "Controls safe search filtering. 0 = off (no filtering), 1 = moderate (default), 2 = strict (filter explicit content).",
                        "default": 1
                    },
                    "fix_typo": {
                        "title": "Auto-correct Spelling",
                        "type": "boolean",
                        "description": "Automatically correct spelling errors in the search query. Default is true.",
                        "default": true
                    },
                    "sort_mode": {
                        "title": "Sort Mode",
                        "enum": [
                            "relevance",
                            "date"
                        ],
                        "type": "string",
                        "description": "How Yandex orders the results. 'relevance' (default) ranks by relevance; 'date' ranks newest first. Applies to all selected result types.",
                        "default": "relevance"
                    },
                    "period": {
                        "title": "Time Period",
                        "enum": [
                            "all",
                            "day",
                            "last_two_weeks",
                            "month"
                        ],
                        "type": "string",
                        "description": "Restrict results to a recency window. 'all' (default) = no time limit; 'day' = last 24 hours; 'last_two_weeks' = last 14 days; 'month' = last 30 days. Applies to all selected result types.",
                        "default": "all"
                    },
                    "output_file": {
                        "title": "Output File",
                        "type": "string",
                        "description": "Optional filename to save results. If not provided, will auto-generate based on search text and parameters."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
