Skip to main content

Scraper API for Yandex

The ScrapeBadger Yandex API turns Yandex Search into a clean JSON feed: the web SERP (organic results with resolved destination URLs, ads, inline images and videos, related searches and pagination), text-query image search with full-resolution URLs and dimensions, and reverse image search by URL (hosting pages, similar images, detected tags and other sizes).
All endpoints are GET, live under https://scrapebadger.com/v1/yandex/*, and authenticate with the X-API-Key header. Credits are charged per request (see the table below) and reported on the X-Credits-Used response header.

Features

  • Web SERP — organic results with position, resolved destination url (Yandex’s /r?u= redirects are decoded), displayed_url, domain, snippet, favicon and sitelinks[], plus ads[], inline_images[], inline_videos[], related_searches[], an optional knowledge_graph and pagination.
  • Image search — full-resolution image (url, width, height), thumbnail, the page the image lives on (source_url) and suggested_searches[].
  • Reverse image search — pass a public image URL and get the pages that host it (sites[]), visually similar_images[], detected tags[] and the same image at other_sizes[], via Yandex’s two-step CBIR flow.

Markets

Yandex localises by domain (TLD), not a query parameter. The domain parameter selects one of tr (yandex.com.tr), com, ru, by, kz or uz.
The default is tr (yandex.com.tr) — measured to reliably clear Yandex’s anti-bot. com and ru serve SmartCaptcha far more often and have a lower success rate; prefer tr unless you specifically need another region’s index.
GET /v1/yandex/markets (free) returns the supported domains with their default region (lr) and language.

Credits

Quickstart

Other notes

  • The domain is the anti-bot lever. yandex.com.tr clears reliably; yandex.com/.ru frequently serve SmartCaptcha. The scraper defaults to tr and recovers blocks by re-rolling a fresh Turkish residential exit.
  • Organic url values are final destinations. Yandex wraps results in a /r?u= tracking redirect; the API unwraps it so you get the real URL.
  • Reverse image search is a two-step flow. The API uploads/derives a cbir_id for your image, then reads the hosting pages, similar images, tags and other sizes. An image with no matches returns is_empty: true.

Errors

Keep domain=tr for the highest success rate. Only switch domains when you specifically need another country’s ranking, and expect a lower clear rate on com/ru.

Run this asynchronously

Calls on this API can run in the background, so you don’t hold a connection open while they work. Add one of these to the call:
An async call is billed once, when it completes. See Async requests and webhooks for webhooks, signatures and the SDK helpers.
ScrapeBadger is an independent tool and is not affiliated with, endorsed by, or sponsored by Yandex. “Yandex” is a trademark of Yandex LLC, used here only to describe the platform this scraper is designed to work with.