Yandex Scraper by ScrapeBadger — Overview

​

Scraper API for Yandex

​

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

​

Credits

​

Quickstart

curl "https://scrapebadger.com/v1/yandex/search?query=coffee+machine&domain=tr" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch(
  "https://scrapebadger.com/v1/yandex/search?" +
    new URLSearchParams({ query: "coffee machine", domain: "tr" }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
console.log(data.result_count, "organic results");

import requests

res = requests.get(
    "https://scrapebadger.com/v1/yandex/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"query": "coffee machine", "domain": "tr"},
)
data = res.json()
print(data["result_count"], "organic results")

​

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