# Yandex (/docs/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](/docs/bing.md) and [DuckDuckGo](/docs/duckduckgo.md): `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 ### Search Pass your search terms as `query`. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/yandex/search?query=heat%20pump%20efficiency" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="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`. ```bash title="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](/docs/bing.md): 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. ```bash title="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 **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](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/yandex/images` | about 30 | none | up to 5,000 rows or 50 pages | | `/v1/yandex/search` | about 10 | none | up to 5,000 rows or 50 pages | ## Next steps - [Bing](/docs/bing.md): The same rows from Bing, with rank checks. - [Pagination](/docs/pagination.md): How cursors work across every list endpoint.