Yandex Search Engine Results API
/search?engine=yandex API endpoint allows you to scrape the results from Yandex search engine via our SerpApi service. Head to the playground for a live and interactive demo.
API Parameters
Localization
yandex_domain
Optional
Parameter defines the Yandex domain to use. It defaults to yandex.com. Head to the Yandex domains for a full list of supported Yandex domains.
A default lr is used for each yandex_domain.
Example: 84(US) for yandex.com
A default lang parameter en(English) is used for yandex.com
lang
Optional
Parameter defines the language to use for the Yandex search. Head to the Yandex languages for a full list of supported Yandex languages.
It defaults to en when yandex_domain is yandex.com. If you want to disable this parameter, set its value to null("Unspecified").
You can also pass 2-letter country codes separated by commas, for example: ru,en to get results in multiple languages.
Geographic Location
lr
Optional
Parameter defines country or region ID to limit the search results to. Head to the Yandex locations for a full list of supported Yandex locations.
If parameter is not set - the matching location of selected yandex_domain is used, e.g. 84 for yandex.com.
Serpapi Parameters
no_cache
Optional
Parameter will force SerpApi to fetch the Yandex results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.
async
Optional
Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.
zero_trace
Optional
Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.
API Results
JSON Results
JSON output includes structured data for organic results, knowledge graph, inline images and inline videos.
A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.
HTML Results
HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Yandex.
API Examples
Example results for text: coffee
{
"search_metadata": {
"id": "67740095c057491092b28d28",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/bb85db7bea38c00a/67740095c057491092b28d28.json",
"created_at": "2024-12-31 14:32:53 UTC",
"processed_at": "2024-12-31 14:32:53 UTC",
"yandex_url": "https://yandex.com/search/?text=coffee",
"raw_html_file": "https://serpapi.com/searches/bb85db7bea38c00a/67740095c057491092b28d28.html",
"total_time_taken": 1.4
},
"search_parameters": {
"text": "coffee",
"engine": "yandex"
},
"search_information": {
"organic_results_state": "Results for exact spelling",
"query_displayed": "coffee"
},
"organic_results": [
{
"position": 1,
"title": "Coffee - Wikipedia",
"link": "https://en.wikipedia.org/wiki/Coffee",
"displayed_link": "en.wikipedia.org›Coffee",
"snippet": "In a commonly repeated legend, Kaldi, a 9th-century Ethiopian goatherd, first observed the coffee plant after seeing his flock energized by chewing on the plant.[3]..."
},
{
"position": 2,
"title": "Coffee: A Full Overview. If you are like most people... | Medium",
"link": "https://inovize.medium.com/coffee-a-full-overview-269be1d5d5e2",
"displayed_link": "inovize.medium.com›coffee-a-full-overview-…",
"snippet": "Coffee is a delicious and fascinating drink. In this article, we will dive into everything you need to know about coffee, from its origin and history to its types and uses."
},
{
"position": 3,
"title": "10 Surprising Facts About Coffee",
"link": "https://www.linkedin.com/pulse/10-surprising-facts-coffee-abdelrhman-ali",
"displayed_link": "linkedin.com›pulse/10-surprising-facts-coffee-…",
"snippet": "Coffee is one of the world's most beloved beverages, consumed by millions of people every day."
},
{
"position": 4,
"title": "Coffee | Origin, Types, Uses, History, & Facts | Britannica",
"link": "https://www.britannica.com/topic/coffee",
"displayed_link": "britannica.com›topic/coffee",
"snippet": "coffee beans, ground coffee, cup of coffee. ... Coffee is a beverage brewed from the roasted and ground seeds of the tropical evergreen coffee plant."
},
{
"position": 5,
"title": "Different Types of Coffee, Roasts, and Drinks",
"link": "https://www.allrecipes.com/article/types-of-coffee/",
"displayed_link": "allrecipes.com›article/types-of-coffee/",
"snippet": "Black coffee is more simple and humble: hot water dripped over ground coffee beans for a low-to medium-concentration of coffee and caffeine."
},
...
],
"pagination": {
"current": 1,
"next": "https://yandex.com/search/?msid=1735655635226972-10463814238228418245-balancer-l7leveler-kubr-yp-sas-547-BAL-952&lang=en&text=coffee&clid=214688&lr=84&p=1&rnd=16024",
"other_pages": {
"2": "https://yandex.com/search/?msid=1735655635226972-10463814238228418245-balancer-l7leveler-kubr-yp-sas-547-BAL-952&lang=en&text=coffee&clid=214688&lr=84&p=1",
"3": "https://yandex.com/search/?msid=1735655635226972-10463814238228418245-balancer-l7leveler-kubr-yp-sas-547-BAL-952&lang=en&text=coffee&clid=214688&lr=84&p=2",
"4": "https://yandex.com/search/?msid=1735655635226972-10463814238228418245-balancer-l7leveler-kubr-yp-sas-547-BAL-952&lang=en&text=coffee&clid=214688&lr=84&p=3",
"5": "https://yandex.com/search/?msid=1735655635226972-10463814238228418245-balancer-l7leveler-kubr-yp-sas-547-BAL-952&lang=en&text=coffee&clid=214688&lr=84&p=4"
}
},
"serpapi_pagination": {
"current": 1,
"next_link": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=en&lr=84&p=1&text=coffee&yandex_domain=yandex.com",
"next": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=en&lr=84&p=1&text=coffee&yandex_domain=yandex.com",
"other_pages": {
"2": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=en&lr=84&p=1&text=coffee&yandex_domain=yandex.com",
"3": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=en&lr=84&p=2&text=coffee&yandex_domain=yandex.com",
"4": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=en&lr=84&p=3&text=coffee&yandex_domain=yandex.com",
"5": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=en&lr=84&p=4&text=coffee&yandex_domain=yandex.com"
}
}
}
More complex examples with multiple optional parameters
The URL below fetches:
- • The forth page (
p=3) of the results, - • for the search "apple" (
q=apple), - • with the French language and domain (
lang=fr, yandex_domain=yandex.com.fr)
{
"search_metadata": {
"id": "67743f3006e74539e8d5955d",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/f6abcc89493ef5ff/67743f3006e74539e8d5955d.json",
"created_at": "2024-12-31 19:00:00 UTC",
"processed_at": "2024-12-31 19:00:00 UTC",
"yandex_url": "https://yandex.com.fr/search/?text=apple&lang=fr&p=3",
"raw_html_file": "https://serpapi.com/searches/f6abcc89493ef5ff/67743f3006e74539e8d5955d.html",
"total_time_taken": 1.19
},
"search_parameters": {
"text": "apple",
"engine": "yandex",
"lang": "fr",
"p": "3",
"yandex_domain": "yandex.fr"
},
"search_information": {
"organic_results_state": "Results for exact spelling",
"query_displayed": "apple"
},
"organic_results": [
{
"position": 1,
"title": "emojipedia.org/fr/apple",
"link": "https://emojipedia.org/fr/apple",
"displayed_link": "emojipedia.org›fr/apple",
"snippet": "Links to the page contain: native Apple emojis...."
},
{
"position": 2,
"title": "Apple : Les dernières actualités, tests et bons plans - Frandroid",
"link": "https://www.frandroid.com/produits/apple",
"displayed_link": "frandroid.com›produits/apple",
"snippet": "L’Apple Watch Series 9 (45 mm, Cellular) ne résiste pas aux promotions de Noël et perd 200 € de son prix chez Boulanger."
},
{
"position": 3,
"title": "Apple : les articles et enquêtes de la rédaction de Numerama",
"link": "https://www.numerama.com/tag/apple/",
"displayed_link": "numerama.com›tag/apple/",
"snippet": "Sur le papier, Apple Intelligence offre plusieurs fonctions bien pratiques."
},
...
],
"pagination": {
"current": 4,
"next": "https://yandex.com.fr/search/?lang=fr&win=255&suggest_reqid=519949689861149953096633912886385&text=apple&lr=124&msid=173567164831523-10463814238228418245-balancer-l7leveler-kubr-yp-sas-672-BAL-1392&p=4&load-blocks=advanced-search&rnd=78468",
"other_pages": {
"2": "https://yandex.com.fr/search/?lang=fr&win=255&suggest_reqid=519949689861149953096633912886385&text=apple&lr=124&msid=173567164831523-10463814238228418245-balancer-l7leveler-kubr-yp-sas-672-BAL-1392&p=1&load-blocks=advanced-search&rnd=1138",
"3": "https://yandex.com.fr/search/?lang=fr&win=255&suggest_reqid=519949689861149953096633912886385&text=apple&lr=124&msid=173567164831523-10463814238228418245-balancer-l7leveler-kubr-yp-sas-672-BAL-1392&p=2&load-blocks=advanced-search&rnd=1138",
"5": "https://yandex.com.fr/search/?lang=fr&win=255&suggest_reqid=519949689861149953096633912886385&text=apple&lr=124&msid=173567164831523-10463814238228418245-balancer-l7leveler-kubr-yp-sas-672-BAL-1392&p=4&load-blocks=advanced-search&rnd=1138",
"6": "https://yandex.com.fr/search/?lang=fr&win=255&suggest_reqid=519949689861149953096633912886385&text=apple&lr=124&msid=173567164831523-10463814238228418245-balancer-l7leveler-kubr-yp-sas-672-BAL-1392&p=5&load-blocks=advanced-search&rnd=1138"
}
},
"serpapi_pagination": {
"current": 4,
"next_link": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=fr&lr=124&p=4&text=apple&yandex_domain=yandex.com.fr",
"next": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=fr&lr=124&p=4&text=apple&yandex_domain=yandex.com.fr",
"other_pages": {
"2": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=fr&lr=124&p=1&text=apple&yandex_domain=yandex.com.fr",
"3": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=fr&lr=124&p=2&text=apple&yandex_domain=yandex.com.fr",
"5": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=fr&lr=124&p=4&text=apple&yandex_domain=yandex.com.fr",
"6": "https://serpapi.com/search.json?device=desktop&engine=yandex&lang=fr&lr=124&p=5&text=apple&yandex_domain=yandex.com.fr"
}
}
}
Example using | (OR) operator
Note that lang have to be set to null to make the search work
{
...
"organic_results": [
{
"position": 1,
"title": "Late Breakfast Early Lunch... - YouTube",
"link": "https://www.youtube.com/watch?v=ztr_TROa7I8",
"displayed_link": "youtube.com›watch",
"snippet": "О сервисе Прессе Авторские права Связаться с нами Авторам Рекламодателям..."
},
{
"position": 2,
"title": "Does Late Breakfast and Early Dinner Really Help Us Lose...",
"link": "https://possible.in/is-late-breakfast-and-early-dinner-for-weight-loss-a-reality-or-myth.html",
"displayed_link": "possible.in›is-late-breakfast-and-early-dinner-…",
"snippet": "Being consistent with late breakfast and early dinner will make your body adapted to the routine, but you cannot always follow it in certain social conditions where you have to compromise your routine."
},
{
"position": 3,
"title": "Late breakfast, or early lunch WOW Guru",
"link": "https://wordsanswers.info/puzzle/wow-guru-answers/wow-guru-yushan/wow-guru-yushan-level-1614/late-breakfast-or-early-lunch-1614",
"displayed_link": "wordsanswers.info›puzzle/wow-guru-answers/wow-…",
"snippet": "It helps you with WOW Guru Late breakfast, or early lunch answers, some additional solutions and useful tips and tricks. In addition to WOW Guru, the developer Fugo Games has created other amazing games."
},
...
],
...
}
Example results for text: Coffee, lang: ru,en
Yandex Search API supports multiple languages. You can specify the language of the search results using the lang parameter. The lang parameter accepts a comma-separated two-letter list of languages.
{
"search_metadata": {
"id": "65eb0b70914a81d45f9e37af",
"status": "Success",
"json_endpoint": "https://serpapi.com/searches/a8cbecfa43d41868/65eb0b70914a81d45f9e37af.json",
"created_at": "2024-03-08 12:58:24 UTC",
"processed_at": "2024-03-08 12:58:24 UTC",
"yandex_url": "https://yandex.com/search/?text=Coffee&lang=ru,en&lr=84&rstr=-84",
"raw_html_file": "https://serpapi.com/searches/a8cbecfa43d41868/65eb0b70914a81d45f9e37af.html",
"total_time_taken": 1.97
},
"search_parameters": {
"text": "Coffee",
"engine": "yandex",
"lang": "ru,en",
"lr": "84",
"yandex_domain": "yandex.com",
"device": "desktop"
},
"search_information": {
"organic_results_state": "Results for exact spelling",
"query_displayed": "Coffee"
},
"organic_results": [
{
"position": 1,
"title": "Coffee Around the World",
"link": "https://www.nationalgeographic.com/travel/article/coffee-around-the-world",
"displayed_link": "nationalgeographic.com›travel/article/coffee-…",
"snippet": "Every coffee has particular characteristics, but there are taste generalizations for the three major coffee-growing regions that can be helpful to keep in mind"
},
{
"position": 2,
"title": "Coffee Concentrate Market Size & Growth Report By 2033",
"link": "https://www.factmr.com/report/1755/coffee-concentrate-market",
"displayed_link": "factmr.com›report/1755/coffee-concentrate-market",
"snippet": "Analysis of Coffee Concentrates Market Covering 30+ Countries Including Analysis of US, Canada, UK, Germany, France, Nordics, GCC countries, Japan, Korea and many more."
},
{
"position": 3,
"title": "Кофейная индустрия Латинской Америки",
"link": "https://marketpublishers.ru/lists/12406/news.html",
"displayed_link": "marketpublishers.ru›lists/12406/news.html",
"snippet": "Колумбия славится своим мягким и сбалансированным кофе. Это третий по величине производитель кофе в мире и второй по величине в Латинской Америке."
},
...
],
...
}
JSON structure overview
{
"organic_results": [
{
"position": "Integer - Organic result position",
"title": "String - Organic result title",
"link": "String - Organic result link",
"displayed_link": "String - Organic result displayed link",
"snippet": "String - Organic result snippet",
},
...
],
"knowledge_graph": {
"title": "String - Knowledge graph title",
...
}
}