SocialCrawl

Yandex

Search the web with Yandex and get organic results with their position, title, link, domain and snippet

Yandex is a web search engine. This endpoint returns its organic results for a query in the same rows as Bing and DuckDuckGo: position, title, url, displayed_url, domain, site_name, snippet and date, so one parser reads every engine.

Base URL: /v1/yandex/...

Yandex exposes 2 routes here.

Quickstart

Pass your search terms as query.

cURL
curl "https://www.socialcrawl.dev/v1/yandex/search?query=heat%20pump%20efficiency" \
  -H "x-api-key: YOUR_API_KEY"
Response (trimmed)
{
  "success": true,
  "data": {
    "items": [
      {
        "position": 1,
        "title": "…",
        "url": "https://…",
        "domain": "…",
        "snippet": "…"
      }
    ],
    "next_cursor": "2"
  }
}

Read the next page

Pass the returned next_cursor as cursor.

cURL
curl "https://www.socialcrawl.dev/v1/yandex/search?query=heat%20pump%20efficiency&cursor=2" \
  -H "x-api-key: YOUR_API_KEY"

Search images

GET /v1/yandex/images returns Yandex's image results in the same rows as Bing Images: the full-size image with its width and height, the thumbnail, the title, the page it sits on and the site. Filter by color, type, file_type, aspect, site and recent=true; each row also carries the image's file size in bytes.

cURL
curl "https://www.socialcrawl.dev/v1/yandex/images?query=golden%20retriever" \
  -H "x-api-key: YOUR_API_KEY"

Questions people ask

How do I get the next page?

Pass the next_cursor of a page back as cursor. Yandex serves 10 a page for up to 10 pages.

Why is there no snippet?

Yandex shows a title, a link and the site for each result, and no snippet text, so snippet is null. displayed_url is the site as Yandex shows it.

Can I search yandex.ru?

Yes. domain takes yandex.com (the default), yandex.ru, yandex.by, yandex.kz, yandex.uz or yandex.com.tr, and language sets the search language.

What is date?

The date Yandex prints for the result, exactly as it prints it, or null when it prints none. It is never reformatted.

Does it return ads?

No. Only the organic results.

All endpoints

2 endpoints available.

EndpointPathCredit Tier
Search Yandex Images/v1/yandex/imagesstandard (1cr)
Search the web with Yandex/v1/yandex/searchstandard (1cr)

How far back and how deep

Each list returns one page at a time. Send cursor for the next page, or max_items or max_pages to collect several pages in one call. A page size appears only where it has been verified. How paging works

PathRows per pageDate windowOne call collects
/v1/yandex/imagesabout 30noneup to 5,000 rows or 50 pages
/v1/yandex/searchabout 10noneup to 5,000 rows or 50 pages

Next steps