100 free credits. No credit card required.Start building
Logo
Yandex logoYandex API

Get Yandex results with one API

Search the web with Yandex and get each result's position, title, link, domain and snippet as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Yandex logo
/v1/yandex

2 active endpoints. Web search and image search.

  • GET /v1/yandex/search
  • GET /v1/yandex/images

What Yandex endpoints does SocialCrawl ship?

One read endpoint for Yandex's organic results, 10 a page for up to 10 pages.

Web search

1 credit
/v1/yandex/search

Yandex's organic results for a query, 10 a page for up to 10 pages, each with its position, title, link, the site as Yandex shows it and domain. Choose the Yandex site (yandex.com, yandex.ru, .by, .kz, .uz or .com.tr), the language, newest first or by relevance, how recent, and safe search. Standard tier (1 credit).

query, domain, language, sort_by, time_range, safe_search, page

Image search

1 credit
/v1/yandex/images

Yandex image results for a query, 30 a page: the full-size image with its size in pixels and bytes, the thumbnail, the title, the snippet, the page and the site. Filter by colour, type, file type, aspect, site and recency. Standard tier (1 credit).

query, domain, safe_search, color, type, file_type, aspect, site, recent, cursor

Yandex API2 endpoints supported
View docs
Images
Search

Returns Yandex image results for a query, 30 a page: the full-size image with its size in pixels and bytes, the thumbnail, the title, the snippet, the page and the site.

Use it to collect images for a query with colour, type, file type, aspect, site or recency filters.

1 credit

GET/v1/yandex/images?query=golden+retriever

query · What to search for, up to 2,048 characters.

$ curl https://www.socialcrawl.dev/v1/yandex/images?query=golden+retriever \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Yandex API works

Yandex is a normal SocialCrawl data surface. You call GET /v1/yandex/search with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Yandex account is needed. The same key works across SocialCrawl platforms.

GET with query params

Search takes query, domain, language, sort_by, time_range, safe_search, page. Formats are validated before any charge.

Pay in credits, not seats

Every Yandex search page costs 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Search pages carry a next_cursor while there is more.

The usual integration chain

Most products search once for the terms they track, then page through as deep as they need.

01Search
GET /v1/yandex/search?query=…

the first results page with positions and links

See what ranks for the query, and where a site sits.

02Page through the results
GET /v1/yandex/search?query=…&cursor=…

the next page from next_cursor

Reach deeper positions for the same query.

request
GET /v1/yandex/search?query=heat%20pump%20efficiency
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
response envelope
{
  "success": true,
  "data": {
    "items": [
      {
        "position": 1,
        "title": "…",
        "url": "https://…",
        "domain": "…",
        "snippet": "…"
      }
    ],
    "next_cursor": "2"
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

The rows match GET /v1/bing/search and /v1/duckduckgo/search, so one parser reads every engine.

SearchResultsearch

items[] with position, title, url, displayed_url, domain, site_name, snippet, date; next_cursor, total_results, related_searches

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Yandex is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the yandex route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public results page is read live, with a retry when a read hangs and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    The results are mapped to the shared web search rows, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search: 1 credit a page
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • 10 results a page, 10 pages
  • Organic results only
  • landings.platformBrief.platforms.yandex.api.billingRules.7
  • landings.platformBrief.platforms.yandex.api.billingRules.8

How SocialCrawl gets Yandex data

Yandex results pages are public. We normalize them into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Yandex is for this API

Yandex web results on the Yandex site you pick, for Russian-speaking and Turkish markets and beyond.

How SocialCrawl reaches it

Public data is read on request and normalized server-side, within each source's published usage rules.

What leaves our edge

The shared web search rows: position, title, link, address, domain, snippet and date, the same as Bing and DuckDuckGo.

What we do not ship live

No ads, no account data and no search history.

field map sketch
position, title, link→ items[].position, title, urlposition, title, link
address shown, domain→ items[].displayed_url, domainaddress shown, domain
snippet, date shown→ items[].snippet, datesnippet, date shown

What this API is used for

The jobs this API is most often used for.

2active Yandex endpoints in the registry
1credit per Yandex search page

Rank tracking in Russian-speaking and Turkish markets

Callers search the terms they track on a schedule and record where each site sits. Yandex results in the same rows as Bing and DuckDuckGo, from the same key as the rest of the catalog.

Live misses read the public results page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Rank tracking

Python, scheduled jobs

search the tracked terms each day and record a site's position on Yandex.

Engine comparison

Node, dashboards

run the same query on Yandex, Bing and DuckDuckGo and compare who ranks where.

AI agents

TypeScript, tool calls

give an agent Yandex results as a search tool, with links it can read next.

How to call the Yandex API

Every Yandex search page is 1 credit. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/yandex/search?query=heat%20pump%20efficiency" \
  -H "x-api-key: sc_your_api_key_here"
Yandex logoYandex on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Yandex API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Yandex API cover?
It covers 2 endpoint: Images and Search. It returns Yandex's organic web results in the same unified JSON as the other 94 platforms.
What does each result include?
Its position, title, link, the address as Yandex shows it, the domain, the snippet and the date when Yandex prints one. The rows match the Bing and DuckDuckGo search endpoints.
How many results come back per call?
10 a page for up to 10 pages. Pass the returned cursor for the next page.
Does it include ads?
No. Only the organic results are returned.
How much does it cost?
Each results page costs 1 credit, cache hits are free, and bad parameters return 400 without a charge. You start with 100 free credits.
Is scraping Yandex data legal?
SocialCrawl returns publicly available Yandex data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Yandex's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Yandex scraping API vs the official Yandex API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Yandex endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Yandex API reference in the docs

🤖 AI agent or LLM? Read this page as markdown