Dedicated ScrapersYandex Scraper API
Yandex logoDedicated Yandex API

Yandex Scraper API — Web, Image & Reverse Image Search

Structured JSON for Yandex — the Russian and international search engine. Organic web search with sitelinks and related searches, image search, and reverse image search by URL to find where an image is hosted and its visually similar matches. Anti-bot bypass built in. No Yandex account.

6Markets
4Endpoints
ReverseImage search by URL
trDefault market

No credit card required · PAYG credits never expire

GET /v1/yandex/search
# Web search on Yandex
import scrapebadger

client = scrapebadger.ScrapeBadger("sb_live_...")

results = client.yandex.search(
    query="web scraping api"
)
200 OK1.4s · 7 credits
{
  "query": "web scraping api",
  "domain": "tr",
  "result_count": 10,
  "organic_results": [
    { "position": 1, "title": "ScrapeBadger", ... }
  ],
  "ads": [],
  "related_searches": [ ... ]
}
API Reference

Yandex API — 4 Dedicated Endpoints

Structured JSON responses with normalized data models. No HTML parsing. No proxy management. No Yandex API key.

GET
/v1/yandex/search
Organic results, ads, sitelinks and related searches for a query
7 cr / req
GET
/v1/yandex/images/search
Search images by text — thumbnails, source pages and suggested searches
7 cr / req
GET
/v1/yandex/images/reverse
Search by an image URL — visually similar images, hosting sites and tags
10 cr / req
GET
/v1/yandex/markets
The markets this API serves — free, costs no credits
0 cr / req
Coverage

6 Yandex Markets

Yandex is a Russian and international search engine. The domain parameter selects the market — Turkey (tr) is the default, since yandex.com.tr is the only Yandex domain that reliably clears anti-bot at scale.

🇹🇷trTurkey
🌐comInternational
🇷🇺ruRussia
🇧🇾byBelarus
🇰🇿kzKazakhstan
🇺🇿uzUzbekistan
Why Turkey is the default: yandex.com.tr reliably clears anti-bot protection where yandex.ru and other domains are far more likely to be blocked at scale. You can still query any of the six markets explicitly via the domain parameter.
Use Cases

What Developers Build with Yandex Data

A second search engine, a different ranking algorithm, and a reverse image search capability few APIs expose at all.

Second-source SERP data

Cross-check Google rankings against a completely different search engine — Yandex’s ranking algorithm surfaces a different result set worth tracking on its own.

Reverse image investigation

Find where an image originated, who else is hosting it, and which pages reuse it — useful for brand protection, plagiarism checks and OSINT.

Brand & content monitoring

Track brand mentions, counterfeit listings and unauthorized image reuse across a search engine most Western monitoring tools ignore.

Multi-region SEO tracking

Pull organic rankings and ads across six Yandex markets — Turkey, Russia, Belarus, Kazakhstan, Uzbekistan and the international index — from one API.

Training data & research

Collect structured search and image results for ranking research, dataset construction and comparative search-engine analysis.

Image sourcing pipelines

Search images by keyword or find visually similar alternatives to an existing image for content and catalogue-matching pipelines.

How it works

From API call to clean JSON in seconds

No proxy setup. No session management. No anti-bot configuration.

1

Send a request

Call any Yandex endpoint with your API key — a query for search, or an image URL for reverse image search. REST or SDK.

2

We handle the hard parts

ScrapeBadger routes the request through the right exit for the selected market, detects blocks, and retries automatically.

3

Get structured JSON

Receive normalized JSON with organic results, ads, sitelinks, related searches, or reverse-image sites and similarity matches.

Pricing

Pay Per Request. Credits Never Expire.

You only pay for successful responses — failed requests are always free. PAYG credits never expire; volume subscription tiers reduce per-credit cost further.

EndpointCredits / requestPAYGSubscription
Web Search /search7 credits
Image Search /images/search7 credits
Reverse Image Search /images/reverse10 credits
Markets /marketsFree

See the full plan comparison on the pricing page — subscription tiers step down per-credit cost beyond the cheapest column shown above.

Free trial
1,000 credits free
≈ 142 search requests
Credits expire
Never
Buy once, use anytime
Failed requests
Always free
Pay for success only
Live cost estimator
Credits per request7
Total credits needed7,000
Loading plans…
Why ScrapeBadger

Built for Reliability at Scale

ScrapeBadger's Yandex Scraper API handles everything Yandex throws at automated requests — so your pipeline keeps running.

Reverse image search, not just text

Pass any public image URL and get back the sites hosting it, visually similar images, descriptive tags and other available sizes — a capability most search APIs don’t offer at all.

Turkey market by default

yandex.com.tr is the only Yandex domain that reliably clears anti-bot at scale, so it’s the default — switch to com, ru, by, kz or uz with a single parameter when you need another market.

Ads kept separate from organic

Sponsored results are returned in their own field, never mixed into organic_results, so your ranking data stays clean without post-processing.

Sitelinks and related searches included

Organic results carry sitelinks where Yandex shows them, and every search response includes the related searches Yandex suggests at the bottom of the page.

No Yandex account or API key

Only a ScrapeBadger API key is required. No Yandex Webmaster account, no XML search API quota, no upstream approval process.

Pay only for success

A blocked or failed request returns an error and costs nothing. Credits are only deducted when a response is delivered.

Code Examples

Simple Integration. Any Language.

Get started in minutes with Python, Node.js, or plain HTTP requests.

The scrapebadger Node.js library wraps the Yandex API with typed methods. Install with npm install scrapebadger, then start scraping Yandex in a few lines of code.

Node.js — Web search
import ScrapeBadger from 'scrapebadger'

const client = new ScrapeBadger({ apiKey: 'sb_live_...' })

// Organic results, ads and related searches
const res = await client.yandex.search({
  query: 'web scraping api',
  domain: 'tr',
})

for (const r of res.organic_results) {
  console.log(r.position, r.title, r.url)
}
console.log(res.related_searches)
Node.js — Reverse image search
import ScrapeBadger from 'scrapebadger'

const client = new ScrapeBadger({ apiKey: 'sb_live_...' })

// Find where an image is hosted + visually similar matches
const res = await client.yandex.reverseImageSearch({
  imageUrl: 'https://example.com/photo.jpg',
})

console.log(res.result_count, res.is_empty)
for (const site of res.sites) {
  console.log(site.title, site.url, site.domain)
}
console.log(res.similar_images.length, 'similar images')
console.log(res.tags.map((t) => t.text))
FAQ

Frequently Asked Questions

Common questions about scraping Yandex with the API — Python, Node.js, or REST.

What is Yandex, and why scrape it?

Yandex is a Russian and international search engine — the dominant engine in Russia and widely used across Turkey, Belarus, Kazakhstan and Uzbekistan. Its ranking algorithm and index differ meaningfully from Google’s, making it a useful second data source for SEO, monitoring and research.

What makes reverse image search useful here?

Pass a public image URL to /images/reverse and get back the sites hosting that image, visually similar images, descriptive tags Yandex has assigned, and other available sizes. It is a differentiated capability for brand protection, OSINT and plagiarism checks that few scraping APIs expose.

Why is the default market Turkey (tr) instead of the main yandex.ru?

yandex.com.tr is the only Yandex domain that reliably clears anti-bot protection at scale. You can still query com, ru, by, kz or uz explicitly via the domain parameter — results just come back less reliably on the higher-risk domains.

Do I need a Yandex account or API key?

No. You only need a ScrapeBadger API key. There is no Yandex Webmaster account, XML search API quota or upstream approval involved.

What happens if a request is blocked?

It returns an error response and costs you nothing. Credits are only deducted for successful responses, so blocks and retries are always free.

Plans & subscriptions

Bigger volume? Save up to 64%

Per-request credit costs are listed above. For higher monthly volume, subscription tiers reduce the per-credit rate substantially. All Yandex endpoints — web search, image search and reverse image search — are included on every plan.

Get started

Start Scraping Yandex Today

1,000 free credits. No credit card. Get your API key in under a minute.

PAYG credits never expire · Pay only for successful requests · 6 markets