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
Search
Pass your search terms as query.
curl "https://www.socialcrawl.dev/v1/yandex/search?query=heat%20pump%20efficiency" \
-H "x-api-key: YOUR_API_KEY"{
"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 "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 "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.
| Endpoint | Path | Credit Tier |
|---|---|---|
| Search Yandex Images | /v1/yandex/images | standard (1cr) |
| Search the web with Yandex | /v1/yandex/search | standard (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
| 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 |
