Yandex Search Scraper – SERP API for Organic Results, Ads & Knowledge Graph

A pay-per-result Yandex SERP scraper. Get clean, structured organic results, paid ads, knowledge graph, inline images and videos, plus dedicated Yandex Images and Yandex Videos vertical search, across 6 Yandex domains and 19 languages.

This is the Pay-Per-Result Edition. If you prefer the Pay-Per-Event billing model instead, see ApifyYandex – Pay-Per-Event Edition.

Python quick-start example (Pay-Per-Result): github.com/johnisanerd/Apify-Yandex-Pay-Per-Result Python quick-start example (Pay-Per-Event): github.com/johnisanerd/Apify-Yandex-Search-Scraper

---

What this actor returns

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

• Organic results - the standard ranked links, present on every search: position, title, URL, displayed link, snippet, thumbnail, favicon, date, sitelinks, and rich snippet data.
• Ads - paid placements shown on commercial queries: position, title, ad URL, displayed link, ad copy, and ad sitelinks.
• Knowledge graph - the entity card Yandex shows for people, TV shows, places, companies, and other known entities: title, type, description, source, image, and attributes (cast, genre, country, people, see-also links).
• Inline images - the image strip that can appear between organic results: title, image URL, link, and thumbnail.
• Inline videos - the video carousel that can appear between organic results: title, link, source, duration, thumbnail, views, and date.
• Yandex Images (dedicated vertical) - full image search results straight from the Yandex Images engine, up to 30 per page: original full-size image URL, hosting page, thumbnail, and source, with filters for image type, color, orientation, file format, exact size, source site, and recency.
• Yandex Videos (dedicated vertical) - full video search results straight from the Yandex Videos engine, up to 30 per page: title, link, duration, views, publish date, source platform, and channel (name, link, verified), with duration and HD filters.
• Run metadata - on every item: search timestamp, total results found, pages processed, pagination state, sort mode, time period, and the full search parameters used.

Choose your result types (à la carte)

Toggle each result type independently: Organic results (on by default), Ads, Knowledge graph, Inline images, Inline videos, Yandex Images vertical, Yandex Videos vertical. Each selected type that appears on a page is delivered as its own dataset item, tagged with an item_type field (organic, ads, knowledge_graph, inline_images, inline_videos, image_search, video_search). Because billing is per dataset item, you pay only for the result types you turn on - a default organic-only run costs exactly what it did before. The page limit applies to every selected type together. Two optional SERP-wide filters are available: sort_mode (relevance or date) and period (all, day, last_two_weeks, month).

Eight dataset preview views (Overview, Organic results, Ads, Knowledge graph, Inline images, Inline videos, Image search, Video search) are available in Apify Console and via API.

Dedicated Yandex Images and Yandex Videos search

Beyond the web SERP, this actor can query the dedicated Yandex Images and Yandex Videos verticals - the same engines behind yandex.com/images and yandex.com/video - and return full vertical results, up to 30 per page.

• Yandex Images (include_image_search): each result carries the original full-size image URL, the hosting page, a thumbnail, and the source. Filter by image type (photo, clipart, line drawing, demotivator, face), color, orientation, file format (JPG, PNG, animated GIF), exact width and height, source site, and recency (last 7 days). Delivered as items with item_type image_search.
• Yandex Videos (include_video_search): each result carries title, link, duration, view count, publish date, source platform, and channel details (name, link, verified). Filter by duration (short, medium, long) and HD quality. Delivered as items with item_type video_search.

A run that enables only a vertical never queries the web SERP. Example - image search only, red square photos:

{
  "text": "matryoshka dolls",
  "include_organic_results": false,
  "include_image_search": true,
  "image_type": "photo",
  "image_color": "red",
  "image_orientation": "square",
  "max_pages": 1
}

Example - video search only, short HD videos:

{
  "text": "borscht recipe",
  "include_organic_results": false,
  "include_video_search": true,
  "video_duration": "short",
  "video_hd": true,
  "max_pages": 1
}

---

Pricing

This actor uses Apify's Pay-Per-Result billing model. You're charged per dataset item produced. With organic results only (the default), 1 fetched page = 1 dataset item. If you opt into extra result types, each selected type present on a page is its own item billed at the same per-result rate - so you pay only for the types you turn on.

Run configuration	Dataset items	Estimated cost
max_pages: 1, organic only (default)	1	~$0.025
max_pages: 2, organic only (default)	2	~$0.05
max_pages: 1, organic + ads + knowledge graph (all present)	up to 3	~$0.075
max_pages: 1, Yandex Images vertical only (up to 30 images)	1	~$0.025
max_pages: 1, organic + Images + Videos verticals	up to 3	~$0.075

The current per-result price is shown on the Apify Store listing. New users get Apify's free-trial credit, which covers several test runs before committing.

Important: because billing is per dataset item, a search that legitimately returns zero results for your selected types still pushes one summary item to ensure transparent billing. Invalid input and upstream API failures fail the run instead - they do not produce a billable item. Set max_pages conservatively and enable only the result types you need on first runs.

---

Use cases

• Russian-market SEO rank tracking: monitor where your domain ranks on yandex.ru for target keywords across regions like Moscow (lr=213) and Saint Petersburg (lr=2).
• Competitor SERP monitoring on Yandex: daily snapshots of organic + paid positions for branded and category queries.
• Localized keyword research across CIS countries: run the same query across yandex.kz, yandex.by, yandex.uz, yandex.com.tr to compare local intent and competition.
• Yandex ads landscape analysis: capture every advertiser, ad copy, and displayed link on a query to build a competitive ad library.
• Knowledge graph entity extraction: pull structured entity cards (companies, people, places) returned by Yandex for branded or factual queries.
• Image dataset collection from Yandex Images: gather full-size image URLs with type, color, orientation, size, and source-site filters for ML training sets, brand monitoring, or visual research.
• Video research on Yandex Videos: collect video titles, links, durations, view counts, and channel data for any query, filtered by length and HD quality.

---

Quick start

The fastest possible run, just paste a query:

{ "text": "iphone 15 review", "yandex_domain": "yandex.ru" }

More examples

Default search (yandex.com / English / 2 pages):

{ "text": "python tutorial" }

Russian-market query with a 3-page cap:

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

Region-targeted English search (lr 84 = USA):

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

---

Input parameters

Parameter	Type	Required	Default	Description
text	string	✅	"python tutorial"	Search query. Supports any operator yandex.com supports (site:, -, quotes).
include_organic_results	boolean	❌	true	Return organic results (item_type organic).
include_ads	boolean	❌	false	Return paid ads when present (item_type ads).
include_knowledge_graph	boolean	❌	false	Return the knowledge graph card when present (item_type knowledge_graph).
include_inline_images	boolean	❌	false	Return the inline image strip (item_type inline_images).
include_inline_videos	boolean	❌	false	Return the inline video carousel (item_type inline_videos).
include_image_search	boolean	❌	false	Query the dedicated Yandex Images vertical (item_type image_search).
include_video_search	boolean	❌	false	Query the dedicated Yandex Videos vertical (item_type video_search).
image_type	string	❌	"any"	Image filter: photo, clipart, lineart, demotivator, face.
image_color	string	❌	"any"	Image filter: color, gray, or a specific color like red, blue.
image_orientation	string	❌	"any"	Image filter: horizontal, vertical, square.
image_file_type	string	❌	"any"	Image filter: jpg, png, gifan (animated GIF).
image_width	integer	❌	(none)	Exact pixel width; set together with image_height.
image_height	integer	❌	(none)	Exact pixel height; set together with image_width.
image_site	string	❌	(none)	Only images hosted on this site, e.g. commons.wikimedia.org.
image_recent	boolean	❌	false	Only images from the last 7 days.
video_duration	string	❌	"any"	Video filter: short, medium, long.
video_hd	boolean	❌	false	Only high-definition videos.
yandex_domain	string	❌	"yandex.com"	Regional Yandex domain (see table below).
lang	string	❌	"en"	Language code, or "null" for the domain's default. Comma-separate for multi-language (e.g. "ru,en").
lr	string	❌	(domain default)	Yandex region ID. Examples: 225 Russia, 84 USA, 213 Moscow, 2 Saint Petersburg.
max_pages	integer	❌	2	Max SERP pages to fetch. Applies to every selected result type. 0 = no cap.
sort_mode	string	❌	"relevance"	Result ordering: "relevance" or "date".
period	string	❌	"all"	Recency window: "all", "day", "last_two_weeks", "month".
output_file	string	❌	(auto)	Optional output filename; auto-generated from query and parameters if omitted.

---

Output

Each selected result type present on a page is pushed to the dataset as its own item, tagged with item_type. The Apify dataset preview offers six tabular views, Search overview, Organic results, Ads, Knowledge graph, Inline images, Inline videos, or you can export the raw JSON.

Preview (organic results view)

Position	Title	URL	Snippet	Date
1	Machine Learning Tutorial	example.com/ml-tutorial	Learn machine learning fundamentals…	2024-01-15
2	Intro to ML, Coursera	coursera.org/intro-ml	A free introductory course covering…	None

Full 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": []
    }
  }
}

---

Supported Yandex domains

Domain	Country / region	Default region ID (lr)	Default language
yandex.com	United States	84	English
yandex.ru	Russia	225	Russian
yandex.by	Belarus	149	Belorussian
yandex.kz	Kazakhstan	159	Kazakh
yandex.uz	Uzbekistan	236	Uzbek
yandex.com.tr	Turkey	983	Turkish

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.

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

Supported languages

Code	Language
null	Auto / domain default (recommended)
ru	Russian
en	English
be	Belorussian
fr	French
de	German
id	Indonesian
kk	Kazakh
tt	Tatar
tr	Turkish
uk	Ukrainian
uz	Uzbek
az	Azerbaijani
hy	Armenian
lv	Latvian
lt	Lithuanian
et	Estonian
ro	Romanian
tk	Turkmen

You can pass multiple languages comma-separated, e.g. "ru,en".

---

Why this actor

Performance & reliability: built for high-throughput scraping with automatic pagination handling. Predictable cost: pay-per-result billing means your bill scales with max_pages, not with run time or memory. Full SERP coverage: organic, ads, knowledge graph, inline images and inline videos in one consistent JSON shape. Localization-first: 15 regional Yandex domains and 19 languages out of the box. Region targeting: override the lr parameter to scrape Yandex from any specific city or oblast. Production-ready output: clean, deterministic field names; no surprise nulls; safe for ETL pipelines.

"In Soviet Russia, Yandex website scrapes you!" 🇷🇺🇺🇸, but here it's the other way around.

---

FAQ

How is billing calculated? One fetched Yandex page = one dataset item = one paid result. A run with max_pages: 3 produces up to 3 items. Even an error page is pushed as a single dataset item to keep billing transparent and predictable.

Why does my result count seem low (or high)? Yandex returns ~10 organic results per page. If max_pages: 3 returned only 24 results, Yandex's last page was partial, that's normal. If the count seems too high, the query may be matching ads, knowledge-graph entries, and inline images/videos, all of which sit alongside organic results in the output.

Can I scrape Yandex Images, Maps or News? Yandex Images and Yandex Videos: yes. Enable include_image_search or include_video_search to query those dedicated verticals directly, with filters, up to 30 results per page, each page billed as one dataset item. Yandex Maps and Yandex News are separate verticals not supported here.

Can I search in multiple languages at once? Yes, pass lang as a comma-separated list, e.g. "ru,en". Yandex will return results from any of the listed languages.

Where do I find a lr (region) ID? The most common ones are in the Supported Yandex domains table above. For specific cities or oblasts inside Russia, common values: 213 Moscow, 2 Saint Petersburg, 54 Yekaterinburg, 47 Nizhny Novgorod, 65 Novosibirsk. Yandex's full region taxonomy is documented online.

What happens if max_pages is higher than the available results? Pagination stops at Yandex's last available page; you won't be billed for empty pages. The output's pagination_info.pagination_stopped_by_limit field tells you whether your max_pages cap or Yandex's natural last page ended the run.

---

Source code & examples

• Apify Store listing: apify.com/johnvc/yandex-scrape-yandex-search-results-at-scale---per-result
• Pay-Per-Result Python example: github.com/johnisanerd/Apify-Yandex-Pay-Per-Result
• Pay-Per-Event Python example: github.com/johnisanerd/Apify-Yandex-Search-Scraper
• Use via MCP (AI agent integration): docs.apify.com/platform/integrations/mcp

---

Changelog

• 0.4 (current), Added dedicated Yandex Images and Yandex Videos vertical search: new opt-in toggles include_image_search and include_video_search with image filters (type, color, orientation, file format, exact size, source site, recency) and video filters (duration, HD). Each vertical page is one dataset item (item_type image_search / video_search), up to 30 results per page. Two new dataset views. Fully backwards compatible - default runs are unchanged.
• 0.3, Added six dataset preview views (overview, organic, ads, knowledge graph, images, videos); grouped input fields into Search / Localization / Run limits sections; expanded README with use cases, FAQ, and full domain/language tables. Fully backwards compatible, no input or output schema changes.

---

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.

• Track Yandex rankings for 1,000 keywords - per-result billing for big keyword lists with positions and snippets.
• Bulk-collect Yandex SERPs for SEO monitoring - clean SERP rows for ongoing SEO monitoring at per-result prices.
• Get Yandex SERP data in Claude via MCP - let Claude pull live Yandex SERPs through MCP (free trial available).

---

• Track Russian Yandex SERPs at scale - pull Russian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Russian..
• Track English Yandex SERPs at scale - pull English Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to English..
• Track Belarusian Yandex SERPs at scale - pull Belarusian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Belarusian..
• Track Ukrainian Yandex SERPs at scale - pull Ukrainian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Ukrainian..
• Track Kazakh Yandex SERPs at scale - pull Kazakh Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Kazakh..
• Track Tatar Yandex SERPs at scale - pull Tatar Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Tatar..
• Track Turkish Yandex SERPs at scale - pull Turkish Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Turkish..
• Track Uzbek Yandex SERPs at scale - pull Uzbek Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Uzbek..
• Track Azerbaijani Yandex SERPs at scale - pull Azerbaijani Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Azerbaijani..
• Track Armenian Yandex SERPs at scale - pull Armenian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Armenian..
• Track French Yandex SERPs at scale - pull French Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to French..
• Track German Yandex SERPs at scale - pull German Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to German..
• Track Indonesian Yandex SERPs at scale - pull Indonesian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Indonesian..
• Track Latvian Yandex SERPs at scale - pull Latvian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Latvian..
• Track Lithuanian Yandex SERPs at scale - pull Lithuanian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Lithuanian..
• Track Estonian Yandex SERPs at scale - pull Estonian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Estonian..
• Track Romanian Yandex SERPs at scale - pull Romanian Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Romanian..
• Track Turkmen Yandex SERPs at scale - pull Turkmen Yandex search results in bulk, pay per result: organic listings with titles, links, and snippets as JSON, language preset to Turkmen..

---

• Monitor Yandex Search Ads by Keyword - track paid ads on Yandex for any keyword, pay per result: each ad's position, title, link, displayed URL, and snippet as JSON.
• Get Yandex Knowledge Graph Entity Data - pull entity cards for a brand, person, or topic, pay per result: title, description, type, source, and image.
• Track Yandex Video Results by Query - collect the inline video carousel for any query, pay per result: each video's title, link, source, duration, and view count.
• Extract Yandex Inline Images by Query - collect the inline image strip for any query, pay per result: each image's title, thumbnail, and link.
• Track Recent Yandex Results from the Last Month - pull fresh organic results from the last month, pay per result, for freshness-sensitive monitoring at scale.
• Sort Yandex Results by Date at Scale - pull organic results ordered by date instead of relevance, pay per result, for news and time-series tracking.
• Export Yandex Search Results to CSV

Также на русском (Russian)

• API выдачи Яндекса: массовый сбор SERP для SEO
• Yandex SERP API: выдача Яндекса в Claude
• Позиции в Яндексе для 1000 запросов: API
• Яндекс SERP API: массовая выдача, оплата за результат
• API выдачи Яндекса по Беларуси: массовый сбор
• Yandex API: украинская выдача, оплата за результат
• API выдачи Яндекса по Казахстану: массовый сбор
• API татарской выдачи Yandex: массовый сбор
• API узбекской выдачи Яндекса: массовый сбор SERP
• Yandex SERP API: азербайджанская выдача оптом
• API выдачи Яндекса по Армении, оплата за результат
• API выдачи Яндекса по Туркменистану оптом
• API рекламы Яндекса по ключевым словам
• Данные графа знаний Яндекса: API с оплатой за результат
• API видео Яндекса по запросу: оплата за результат
• Яндекс: картинки из выдачи по запросу, API
• Yandex API: свежие результаты за месяц
• Yandex API: выдача по дате, оплата за результат
• Экспорт выдачи Яндекса в CSV: оплата за результат

Last Updated: 2026.07.08