Yandex Search

Get Yandex web search results.

GET/api/v1/yandex/search

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Search parameters

Parameter	Type	Description
`yandex_domain`	"yandex.com" \| "yandex.ru" \| "yandex.by" \| "yandex.kz" \| "yandex.uz" \| "yandex.com.tr"	Yandex domain to search.Default: yandex.com.
`family_mode`	"0" \| "1" \| "2"	Safe search: 0 off, 1 moderate, 2 strict.Default: 1.
`p`	integer	Page number, starting at zero.Default: 0.Minimum: 0.
`text`required	string	Search query, including Yandex query operators.Up to 400 characters.
`lang`	string	Search language code; defaults to en on yandex.com.
`lr`	integer	Country or region ID; defaults to the selected domain's region.Minimum: 0.
`fix_typo`	boolean	Automatically correct spelling.Default: true.
`groups_on_page`	integer	Maximum result groups per page.Default: 20.Minimum: 1.
`sort_mode`	"relevance" \| "date"	Sort results by relevance or date.Default: relevance.
`period`	"all" \| "day" \| "last_two_weeks" \| "month"	Time period for results.Default: all.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: organic_results. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/yandex/search?text=python+documentation" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "text": "python documentation"
});
const res = await fetch(`https://serpfast.com/api/v1/yandex/search?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "text": "python documentation"
}
res = requests.get(
    "https://serpfast.com/api/v1/yandex/search",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())