Yandex Search Scraper

Search Yandex using keywords and the same region, language, time, family, and site filters a visitor would choose. The Actor supports one query or a deduplicated list and enforces one global maximum across the run.

Output

Each organic result can include stable identity and ranking fields, title and snippet text/HTML, canonical destination and displayed URLs, domain, favicon, thumbnail, highlighted terms, breadcrumbs, labels, sitelinks, rich-result ratings/reviews/prices, date information, advertising/official flags, search context, extraction method, and timestamp.

Optional values are omitted when Yandex does not expose them. Records never contain placeholder null, empty strings/arrays, CAPTCHA pages, or raw transport responses.

Inputs

Field	Purpose	Default
query	Primary Yandex query	artificial intelligence
queries	Additional deduplicated queries	[]
site	Optional site: domain filter	empty
lr	Numeric Yandex region code	automatic
country	Optional proxy-country alignment	automatic
language	Search/interface language	en
timeRange	Any time, past day, week, or month	any
familyFilter	Off, moderate, or strict	moderate
maxItems	Global unique-record limit	20
maxPages	Maximum pages per query	5
maxConcurrency	Parallel pages	2
proxyConfiguration	Apify or user-provided proxies	Residential

Example:

{
  "query": "machine learning",
  "queries": ["large language models"],
  "lr": "213",
  "language": "en",
  "timeRange": "7",
  "familyFilter": "moderate",
  "maxItems": 30,
  "maxPages": 3,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Reliability

The Actor validates status and content type before parsing, uses country/language-consistent desktop fingerprints, short-lived persistent sessions, stable canonical-URL deduplication, and bounded retries for temporary HTTP/proxy/browser failures. Explicit CAPTCHA or robot-verification pages are terminal, marked TARGET_BLOCKED, and never stored or bypassed. Confirmed no-result searches finish successfully with an empty dataset; selector drift fails visibly.

Local development

npm ci
npm test
apify run

The checked-in INPUT.json disables proxy use for local diagnosis. Cloud runs use the input schema's Residential default.