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.
No credit card required · PAYG credits never expire
# Web search on Yandex
import scrapebadger
client = scrapebadger.ScrapeBadger("sb_live_...")
results = client.yandex.search(
query="web scraping api"
){
"query": "web scraping api",
"domain": "tr",
"result_count": 10,
"organic_results": [
{ "position": 1, "title": "ScrapeBadger", ... }
],
"ads": [],
"related_searches": [ ... ]
}Structured JSON responses with normalized data models. No HTML parsing. No proxy management. No Yandex API key.
/v1/yandex/search/v1/yandex/images/search/v1/yandex/images/reverse/v1/yandex/marketsYandex 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.
domain parameter.A second search engine, a different ranking algorithm, and a reverse image search capability few APIs expose at all.
Cross-check Google rankings against a completely different search engine — Yandex’s ranking algorithm surfaces a different result set worth tracking on its own.
Find where an image originated, who else is hosting it, and which pages reuse it — useful for brand protection, plagiarism checks and OSINT.
Track brand mentions, counterfeit listings and unauthorized image reuse across a search engine most Western monitoring tools ignore.
Pull organic rankings and ads across six Yandex markets — Turkey, Russia, Belarus, Kazakhstan, Uzbekistan and the international index — from one API.
Collect structured search and image results for ranking research, dataset construction and comparative search-engine analysis.
Search images by keyword or find visually similar alternatives to an existing image for content and catalogue-matching pipelines.
No proxy setup. No session management. No anti-bot configuration.
Call any Yandex endpoint with your API key — a query for search, or an image URL for reverse image search. REST or SDK.
ScrapeBadger routes the request through the right exit for the selected market, detects blocks, and retries automatically.
Receive normalized JSON with organic results, ads, sitelinks, related searches, or reverse-image sites and similarity matches.
You only pay for successful responses — failed requests are always free. PAYG credits never expire; volume subscription tiers reduce per-credit cost further.
| Endpoint | Credits / request | PAYG | Subscription |
|---|---|---|---|
Web Search /search | 7 credits | — | — |
Image Search /images/search | 7 credits | — | — |
Reverse Image Search /images/reverse | 10 credits | — | — |
Markets /markets | Free | — | — |
See the full plan comparison on the pricing page — subscription tiers step down per-credit cost beyond the cheapest column shown above.
ScrapeBadger's Yandex Scraper API handles everything Yandex throws at automated requests — so your pipeline keeps running.
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.
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.
Sponsored results are returned in their own field, never mixed into organic_results, so your ranking data stays clean without post-processing.
Organic results carry sitelinks where Yandex shows them, and every search response includes the related searches Yandex suggests at the bottom of the page.
Only a ScrapeBadger API key is required. No Yandex Webmaster account, no XML search API quota, no upstream approval process.
A blocked or failed request returns an error and costs nothing. Credits are only deducted when a response is delivered.
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.
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)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))Common questions about scraping Yandex with the API — Python, Node.js, or REST.
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.
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.
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.
No. You only need a ScrapeBadger API key. There is no Yandex Webmaster account, XML search API quota or upstream approval involved.
It returns an error response and costs you nothing. Credits are only deducted for successful responses, so blocks and retries are always free.
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.
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