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

Search Query

text

Required

Parameter defines the search query. You can use anything that you would use in a regular Yandex search.

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.

rstr

Optional

Parameter enables additional filtering to select search results that include specified location (lr) in the text snippets/titles.

Pagination

p

Optional

Parameter defines page number. Pagination starts from 0.

Serpapi Parameters

engine

Required

Set parameter to yandex to use the Yandex API engine.

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.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

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

Example results for text: coffee

JSON Example

{
  "search_metadata": {
    "id": "5e3d845259603db4392078f5",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/d7a266c1bb0fa60c/5e3d845259603db4392078f5.json",
    "created_at": "2020-02-07 15:37:54 UTC",
    "processed_at": "2020-02-07 15:37:54 UTC",
    "yandex_url": "https://yandex.com/search/?text=coffee",
    "raw_html_file": "https://serpapi.com/searches/d7a266c1bb0fa60c/5e3d845259603db4392078f5.html",
    "total_time_taken": 1.4
  },
  "search_parameters": {
    "text": "coffee",
    "engine": "yandex"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    "total_results": " 2 million results found",
    "query_displayed": "coffee"
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Coffee - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "displayed_link": "en.wikipedia.org›Coffee",
      "snippet": "Coffee is a brewed drink prepared from roasted coffee beans, the seeds of berries from certain Coffea species. The genus Coffea is native to tropical Africa (specifically having its origin in Ethiopia and Sudan) and Madagascar, the Comoros, Mauritius, and Réunion in the Indian Ocean. Coffee plants are now cultivated in over 70 countries, primarily in the equatorial regions of the Americas, Southeast Asia, Indian subcontinent, and Africa. The two most commonly grown are C. arabica and C. robusta. Once... Hide"
    },
    {
      "position": 2,
      "title": "List of coffee companies - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/List_of_coffee_companies",
      "displayed_link": "en.wikipedia.org›List of coffee companies",
      "snippet": "This is a worldwide list of coffee companies that roast or distribute coffee. List of coffeehouse chains. Coffee companies at Curlie."
    },
    {
      "position": 3,
      "title": "Home - Coffee Factory and Cafe",
      "link": "https://www.coffeefactoryandcafe.com/",
      "displayed_link": "coffeefactoryandcafe.com",
      "snippet": "Waters and 2 coffees. Coffee was great, not very pretty like a latte should be but, it ... Over all. The coffee was good. Whoever was working today (i will erase his name, no need to..."
    },
    {
      "position": 4,
      "title": "H&C Coffee - Premium Coffee",
      "link": "http://www.hccoffee.com/",
      "displayed_link": "hccoffee.com",
      "snippet": "Coffee Storage. Local Services. Coffee Delivery Service."
    },
    {
      "position": 5,
      "title": "Coffee Company Lancaster PA | Coffee Shop & Cafe Food...",
      "link": "https://www.coffeecocafe.com/",
      "displayed_link": "coffeecocafe.com",
      "snippet": "Coffee Co offers ambiance with no pretense, friendly baristas, delicious homemade food and of course, our legendary coffee. We believe in what a cup of coffee can do to enrich..."
    },
    {
      "position": 6,
      "title": "Coffee - Buy Coffee Beans Online",
      "link": "https://www.coffeecompany.com.au/",
      "displayed_link": "coffeecompany.com.au",
      "snippet": "Coffee Subscription. View the full range of coffee Looking for a unique present for someone special?"
    },
    {
      "position": 7,
      "title": "coffee - Wiktionary",
      "link": "https://en.wiktionary.org/wiki/coffee",
      "displayed_link": "en.wiktionary.org›wiki/coffee",
      "snippet": "From Dutch koffie (“coffee”) [from 1582], from Italian caffè (“coffee”), from Ottoman Turkish قهوه‎ (kahve, “coffee”), from Arabic قَهْوَة‎ (qahwa, “coffee, a brew”). The Arabic word originally referred to wine..."
    },
    {
      "position": 8,
      "title": "Coffee | The Coffee Wiki | Fandom",
      "link": "https://coffee.fandom.com/wiki/Coffee",
      "displayed_link": "coffee.fandom.com›wiki/Coffee",
      "snippet": "Coffee is a caffeinated beverage brewed from roasted coffee beans extracted from the \"cherry\" of a coffee tree. Upon brewing, coffee is a dark, often black beverage, but brown if cream or milk is added."
    },
    {
      "position": 9,
      "title": "US Coffee - Office Coffee Service & Delivery - NY, NJ, Tri-State",
      "link": "https://uscoffee.com/",
      "displayed_link": "uscoffee.com",
      "snippet": "The leading office coffee service for the tri-state area since 1972. Providing full-service office refreshment, water cooler services and next day delivery."
    },
    {
      "position": 10,
      "title": "HOME | Tōv Coffee",
      "link": "https://www.tovcoffee.com/",
      "displayed_link": "tovcoffee.com",
      "snippet": "Tov Coffee is certainly not your average coffee shop, in fact it's not a shop at all, it's a double decker bus specializing in Egyptian coffee. Tov makes all their syrups in house..."
    },
    {
      "position": 11,
      "title": "Coffee - Отели – Выгодные цены без комиссий!",
      "link": "https://yabs.yandex.ru/count/Q9XSoiXvCBC507a24808CLQ4FLu00000EFG3G0H80c2y26W4SEBOmv01W07cYzxV1eW1xi3_koMG0RoAm9yVc07gilAf8BW1jgJLiHJ00GBO0RBn-GxW0Q2EfWNe0H2W0kYtd07O0WBm0eMHW_q7-0AGyOBcfSQurUK1c0Ftvoce0ngm0mIu1Fy1m0Jc0kW4zY3u1D3528W5qCK8a0Nzq4gW1RoI0wW5l983i0MyaWEu1T2x6y05_T1Ao0NGknlW1GNm1G6O1eBGhFCEe0Qe0QW6g0711bQGaAOIvgOioGPMa92c4kQcBDa60000CFi0002f1-zSeCDWpjm5i0U0W9Wyq0S2u0Ua3_47YBnPdD-yHRBu1m60207G29I2W870W826W07W2FIRJe0A0S4A00000000y3_O2WBW2e29UgeB4DiSbSFlN000Ye-EBFwT1G3P2-zSeCDWpjm5w0lGnGZm2mQ83EZkthu1w0mZu0q1YGx3zIXSZyArFv0Em8Gzc0xMeCAqgiAvqooW3i24FTWE1Q4Fm_KeN8_2jJ_P3m0000000F0_u0y1W12YdwuDa12Fki6yf83YtEe1cX094G0000000F0_o10C-10DW14FY141a141eH400000003mFwWHm8Gzi141-X4P3G00000L000001q000009G00000j000008WI0P0I0QaI5xt6pdwPLp_m4WU84mAO4m704____________m7Q4me80100600W02W0u1FGknkW5D2x6wWK_T1Ao1G4q1J___________y1s1JGbxB91T0Lq9UooGNO5S6AzkoZZxpyO_0LmOhsxAEFlFnZ",
      "displayed_link": "booking.com",
      "snippet": "Бронируйте отели в Coffee · Подлинные отзывы. Широкий выбор. 0% комиссии. Без посредников"
    }
  ],
  "inline_images": [
    {
      "title": "Wallpaper Coffee Grain Cup Food Drinks 3840x2400",
      "image": "https://sun9-45.userapi.com/c857624/v857624666/150101/Sg1hLj3htvw.jpg",
      "alternative_images": [
        "https://s1.1zoom.me/b5050/773/Drinks_Coffee_Grain_Cup_484502_3840x2400.jpg"
      ],
      "thumbnail": "https://im0-tub-com.yandex.net/i?id=6a3a8d465e609c015ac882cb258b1f00&n=13",
      "url": "https://yandex.com/images/search?text=coffee&img_url=https%3A%2F%2Fsun9-45.userapi.com%2Fc857624%2Fv857624666%2F150101%2FSg1hLj3htvw.jpg&pos=0&rpt=simage&stype=image&lr=21772&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&source=wiz"
    },
    {
      "title": "User john alroqee - Stack Overflow",
      "image": "https://sun9-68.userapi.com/c857028/v857028441/a76c0/LUSMz13oiWc.jpg",
      "alternative_images": [
        "https://i.stack.imgur.com/FHEyM.jpg?s=136&g=1"
      ],
      "thumbnail": "https://im0-tub-com.yandex.net/i?id=2bb4ab0e9911b223c5a49f8a123727b4&n=13",
      "url": "https://yandex.com/images/search?text=coffee&img_url=https%3A%2F%2Fsun9-68.userapi.com%2Fc857028%2Fv857028441%2Fa76c0%2FLUSMz13oiWc.jpg&pos=1&rpt=simage&stype=image&lr=21772&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&source=wiz"
    },
    {
      "title": "Desktop Wallpapers Coffee Grain Cup Food Vapor Saucer 2560x1",
      "image": "https://s1.1zoom.me/big3/785/350874-admin.jpg",
      "alternative_images": [
        "https://s1.1zoom.me/big7/785/Drinks_Coffee_Grain_Cup_350874.jpg"
      ],
      "thumbnail": "https://im0-tub-com.yandex.net/i?id=c727d96b4b707009a33f3dd17da9eaa2&n=13",
      "url": "https://yandex.com/images/search?text=coffee&img_url=https%3A%2F%2Fs1.1zoom.me%2Fbig3%2F785%2F350874-admin.jpg&pos=2&rpt=simage&stype=image&lr=21772&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&source=wiz"
    },
    {
      "title": "Скачать обои зерна, кофе, кружки, кофейные зерна, деревянная",
      "image": "https://static6.depositphotos.com/1144352/636/i/950/depositphotos_6362396-stock-photo-coffee-beans-and-coffee.jpg",
      "alternative_images": [
        "https://wallbox.ru/wallpapers/main2/201729/zerna-kofe-kruzki.jpg"
      ],
      "thumbnail": "https://im0-tub-com.yandex.net/i?id=cbcbab343d5fc4fcbf2c5f7ee22ecb06&n=13",
      "url": "https://yandex.com/images/search?text=coffee&img_url=https%3A%2F%2Fstatic6.depositphotos.com%2F1144352%2F636%2Fi%2F950%2Fdepositphotos_6362396-stock-photo-coffee-beans-and-coffee.jpg&pos=3&rpt=simage&stype=image&lr=21772&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&source=wiz"
    },
    {
      "title": "Specialty ″Coffee″: Intro to Cupping $35 - The Food District",
      "image": "https://i.ebayimg.com/00/s/MTEwMVgxNjAw/z/CiYAAOSwuxFY0t~n/$_57.JPG?set_id=8800005007",
      "alternative_images": [
        "https://shopfooddistrict.com/wp-content/uploads/2019/04/Coffee-Cupping.gif"
      ]
    },
    {
      "title": "1920x1080 free high resolution wallpaper coffee JPG 354 kB F",
      "image": "https://ae01.alicdn.com/kf/HTB1pNCkmuuSBuNjy1Xcq6AYjFXaB/16-adet-Cappuccino-ikolata-Shaker-Kahve-Un-Elek-eker-Shaker-Paslanmaz-elik-Tuz-Da-t-c.jpg",
      "alternative_images": [
        "https://www.tokkoro.com/picsup/1088513-coffee.jpg"
      ]
    },
    {
      "title": "Coffee LGDF Wholesale",
      "image": "https://www.lgdf.ca/wp-content/uploads/2015/08/istock_000019749073medium.jpg",
      "alternative_images": [
        "https://www.lgdf.ca/wp-content/uploads/2015/08/istock_000019749073medium.jpg"
      ]
    },
    {
      "title": "hkh Я люблю кофе!!! Postila",
      "image": "https://sun9-27.userapi.com/c636628/v636628989/219e7/GuA-HAWBACo.jpg",
      "alternative_images": [
        "https://img11.postila.io/data/d3/3e/9a/b9/d33e9ab9a493189990e33d82d47cd42581915d1748cbb16004357403bab9617a.jpg"
      ]
    },
    {
      "title": "20 things I’d tell you over coffee. (Or more likely, queso.)",
      "image": "https://images.pexels.com/photos/2059/restaurant-red-beans-coffee.jpg?auto=compress&cs=tinysrgb&h=350",
      "alternative_images": [
        "https://acuff.me/wp-content/uploads/2019/01/coffee-171653_1920.jpg"
      ]
    },
    {
      "title": "Coffee Collection 5964 - file.army",
      "image": "https://st.depositphotos.com/2045405/2015/i/950/depositphotos_20159497-stock-photo-coffee.jpg",
      "alternative_images": [
        "https://404store.com/2017/11/15/CoffeeCollection-5964.jpg"
      ]
    },
    {
      "title": "Can Chocolate, Tea, Coffee And Zinc Help Make You More Healt",
      "image": "https://superbekala.com/wp-content/uploads/2019/04/Dollarphotoclub_59335540.jpg",
      "alternative_images": [
        "https://ilovemychiropractor.org/?image=10043"
      ]
    },
    {
      "title": "Coffee Terms ″Defined″: Beans, Brews, and Barista Speak So You",
      "image": "https://st2.depositphotos.com/2632165/9267/i/950/depositphotos_92676178-stock-photo-cup-of-coffee-and-coffee.jpg",
      "alternative_images": [
        "https://img1.cookinglight.timeinc.net/sites/default/files/image/1605w-getty-coffee-beans-cup.jpg"
      ]
    },
    {
      "title": "Is Coffee Making You Fat?",
      "image": "https://st.depositphotos.com/1020804/1263/i/950/depositphotos_12638853-stock-photo-coffee-cup-and-beans.jpg",
      "alternative_images": [
        "https://www.meghantelpner.com/wp-content/uploads/2014/09/shutterstock_111999368.jpg"
      ]
    },
    {
      "title": "1920x1080 drink, foam, Coffee, heart, cup, steam, grains Mac",
      "image": "https://sun9-55.userapi.com/c853424/v853424363/1cdc4a/1jZaC_auiJc.jpg",
      "alternative_images": [
        "https://www.tokkoro.com/picsup/6061170-drink-foam-coffee-heart-cup-steam-grains.jpg"
      ]
    },
    {
      "title": "Wallpaper Coffee Grain Food 2560x1600",
      "image": "https://images-wixmp-ed30a86b8c4ca887773594c2.wixmp.com/f/ab371d58-f694-4953-a2e5-c79acedd9f56/dcuwa1o-33c88fd0-6aa8-431a-8e38-14b9a973e4d6.png/v1/fill/w_1192,h_670,q_70,strp/background_310_by_llexandro_dcuwa1o-pre.jpg?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ1cm46YXBwOjdlMGQxODg5ODIyNjQzNzNhNWYwZDQxNWVhMGQyNmUwIiwiaXNzIjoidXJuOmFwcDo3ZTBkMTg4OTgyMjY0MzczYTVmMGQ0MTVlYTBkMjZlMCIsIm9iaiI6W1t7ImhlaWdodCI6Ijw9MTQ0MCIsInBhdGgiOiJcL2ZcL2FiMzcxZDU4LWY2OTQtNDk1My1hMmU1LWM3OWFjZWRkOWY1NlwvZGN1d2Exby0zM2M4OGZkMC02YWE4LTQzMWEtOGUzOC0xNGI5YTk3M2U0ZDYucG5nIiwid2lkdGgiOiI8PTI1NjAifV1dLCJhdWQiOlsidXJuOnNlcnZpY2U6aW1hZ2Uub3BlcmF0aW9ucyJdfQ.IA28OJrX4mFYP5blUjGsm5dC6JDKsD-TovhWlA5ciow",
      "alternative_images": [
        "https://s1.1zoom.me/big3/178/408894-sepik.jpg"
      ]
    },
    {
      "title": "The Start of Coffee - Addis Coffee - Arabica coffee beans fr",
      "image": "https://img2.goodfon.com/original/5050x3370/6/e4/kofe-pena-zerna-serdce-chashka.jpg",
      "alternative_images": [
        "https://addiscoffee.com.au/wp-content/uploads/2016/02/G11.jpg"
      ]
    },
    {
      "title": "A Cup of Coffee and Bagel with Ivan Frank - Squirrel Hill Ur",
      "image": "https://www.tokkoro.com/picsup/5248291-coffee-latte-espresso-flatlay-wood-cafe-mug-table-cappuccino-java-mocha-creative-artistic-hipster-hippie-joe-brew-starbuck-expresso-coffee-bean-creative-commons-images.jpg",
      "alternative_images": [
        "https://shuc.org/wp-content/uploads/2016/09/coffee-983955.jpg"
      ]
    },
    {
      "title": "5 причин выпить кофе",
      "image": "https://st.depositphotos.com/2632165/3143/i/950/depositphotos_31435437-stock-photo-coffee.jpg",
      "alternative_images": [
        "https://akky.su/upload/medialibrary/9ff/9ffb7c547a80c2d3927fc3f28572bfc6.jpg"
      ]
    },
    {
      "title": "Wallpaper 4k Coffee Art artist wallpapers, beans wallpapers,",
      "image": "https://www.tokkoro.com/picsup/1388463-coffee.jpg",
      "alternative_images": [
        "https://www.pixel4k.com/preview.php?src=https://www.pixel4k.com/wp-content/uploads/2018/10/coffee-art_1540748177.jpg"
      ]
    },
    {
      "title": "#3348189 Coffee, Coffee beans, Spices, Beverage wallpaper an",
      "image": "https://404store.com/2017/04/03/DeliciousFoodWallpapers165.jpg",
      "alternative_images": [
        "https://www.tokkoro.com/picsup/3348189-coffee-coffee-beans-spices-beverage.jpg"
      ]
    }
  ],
  "inline_video": [
    {
      "title": "Craft Coffee",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=4151714475789157047",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/45990802"
      },
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/2089623/574e32d175c8bf461ab2b9507e19bc94/168x95"
    },
    {
      "title": "″Coffeecompany″: The Coffee Story (EN)",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=7627040588496300298",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/87163631"
      },
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/222490/0ed3f21e204e757e6e14c0589abcaf90/168x95"
    },
    {
      "title": "Coffee ″Coffee″: A Specialty Coffee Documentary",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=11085285509500565975",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/133624241"
      },
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/2099966/8b045f31df8dc79ea6e91b49950df2ba/168x95"
    },
    {
      "title": "'Coffee Time'",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=15759789561527005288",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/138402717"
      },
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/1734583/878df9229d108a54c4ea00afa7c9022e/168x95"
    },
    {
      "title": "Stumptown Coffee Roasters.",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=1305175487555494267",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/57430932"
      }
    },
    {
      "title": "How To Make The Perfect Jameson Irish Coffee",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=5940155405026333740",
      "source": {
        "name": "youtube.com",
        "link": "http://www.youtube.com/watch?v=E8gP35w-o5U"
      }
    },
    {
      "title": "Crave Coffee Roastery and Espresso Bar",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=9939498197168220537",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/122376948"
      }
    },
    {
      "title": "Vintage Coffee",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=13962380897409010211",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/151380532"
      }
    },
    {
      "title": "Coffee is not a drug – new case",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=11772832462222367727",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/195424336"
      }
    },
    {
      "title": "Coffee Maker Destruction",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=13917975897069701172",
      "source": {
        "name": "youtube.com",
        "link": "http://www.youtube.com/watch?v=Fj65M_tyRsI"
      }
    },
    {
      "title": "Coffee Virgin",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=2860414124453025325",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/150603479"
      }
    },
    {
      "title": "Coffee Bar",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=4523478549669871838",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/39286333"
      }
    },
    {
      "title": "Coffee Installation",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=12033620648993854005",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/27838096"
      }
    },
    {
      "title": "BOON Coffee Roasters, The Hague.",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=13389209156662617921",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/66081274"
      }
    },
    {
      "title": "Inside ″Coffee″: Specialty Coffee Roasting 101...",
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1&filmId=326267986663064725",
      "source": {
        "name": "vimeo.com",
        "link": "http://vimeo.com/152264714"
      }
    },
    {
      "link": "https://yandex.com/video/search?text=coffee&path=wizard&parent-reqid=1581089878253956-176627422372175119500111-vla1-2993&noreask=1&autoplay=1"
    }
  ]
}

More complex examples with multiple optional parameters

The URL below fetches:

  • • The third page (p=3) of the results,
  • • for the search "apple" (q=apple),
  • • with the Turkish language and domain (lang=tr, yandex_domain=yandex.com.tr)

More complex examples with multiple optional parameters

JSON Example

{
  "search_metadata": {
    "id": "5e3d87ce59603db438ed005c",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/a84580b3b529750c/5e3d87ce59603db438ed005c.json",
    "created_at": "2020-02-07 15:52:46 UTC",
    "processed_at": "2020-02-07 15:52:46 UTC",
    "yandex_url": "https://yandex.com.tr/search/?text=apple&lang=tr&p=2",
    "raw_html_file": "https://serpapi.com/searches/a84580b3b529750c/5e3d87ce59603db438ed005c.html",
    "total_time_taken": 1.19
  },
  "search_parameters": {
    "text": "apple",
    "engine": "yandex",
    "lang": "tr",
    "p": "2"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling",
    "total_results": "13 bin sonuç bulundu",
    "query_displayed": "apple"
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Apple | Teknolojioku",
      "link": "https://www.teknolojioku.com/apple/",
      "displayed_link": "teknolojioku.com›apple/",
      "snippet": "Apple haberleri, fotoğrafları, videoları, yorumları. ... Apple, 2020'de iki milyarıncı iPhone'unu satacak! Güncel. Apple'dan fotoğraf yarışması."
    },
    {
      "position": 2,
      "title": "Apple Arşivleri - Sosyal Medya",
      "link": "https://sosyalmedya.co/apple/",
      "displayed_link": "sosyalmedya.co›apple/",
      "snippet": "Şirket merkezi Cupertino, Kaliforniya’da bulunan Apple’ın başında, 2011 yılında efsaneleşmiş kurucusu Steve Jobs’ın vefatının ardından Tim Cook geçmiştir."
    },
    {
      "position": 3,
      "title": "Sepetiniz Boş",
      "link": "https://www.troyestore.com/",
      "displayed_link": "troyestore.com",
      "snippet": "44 mm Indigo Spor Loop Kordon. 159,00 TL. İNCELE. Apple. ... Spigen Apple iPhone 11 Kılıf Hybrid NX Gold. 179,90 TL. İNCELE."
    },
    {
      "position": 4,
      "title": "Apple Türkiye - Ana Sayfa | Facebook",
      "link": "https://tr-tr.facebook.com/AppleTrky",
      "displayed_link": "tr-tr.facebook.com›AppleTrky",
      "snippet": "Apple Türkiye. 4.031 beğenme · 1 kişi bunun hakkında konuşuyor. Şirket merkezi Cupertino, Kaliforniya, Amerika'dadır. 2011 itibarı ile genel müdürü Tim..."
    },
    {
      "position": 5,
      "title": "Apple Akıllı Telefon, Saat ve Aksesuar Modelleri Turkcell'de",
      "link": "https://www.turkcell.com.tr/apple",
      "displayed_link": "turkcell.com.tr›apple",
      "snippet": "Apple Yeni Model Aksesuar Ve Telefonlarını Ne Zaman Tanıtıyor? Apple Amerika 2019 yılına kadar yeni model aksesuar ve telefonlarını Eylül ayında tanıttı."
    },
    {
      "position": 6,
      "title": "Apple Inc Haberleri – webtekno.com",
      "link": "https://www.webtekno.com/apple",
      "displayed_link": "webtekno.com›apple",
      "snippet": "Apple’ın mobil, akıllı cihaz, bilgisayar ve giyilebilir teknoloji alanında yeni ürünleri, şirket haberleri ve ürün incelemeleri burada yayınlanıyor."
    },
    {
      "position": 7,
      "title": "Apple Haberleri | Apple Haber - Haberler",
      "link": "https://www.haberler.com/apple/",
      "displayed_link": "haberler.com›apple/",
      "snippet": "Apple haberleri, son dakika apple haber ve gelişmeleri burada. Maserati'nin özel serisi Mart'ta Türkiye'de!. ... Apple haber, Apple son dakika haberleri ve gelişmeleri."
    },
    {
      "position": 8,
      "title": "APPLE KUTUSU - Türkiyenin En Uygun Apple Satış Mağazası",
      "link": "https://www.applekutusu.com/",
      "displayed_link": "applekutusu.com",
      "snippet": "• Takas yapılacak urun için +90 212 528 03 04 telefonumuzdan 2.el uzmanımıza bağlanarak urunuzu exper edip fiyat teklifi alabilirisiniz. • Apple ürünleri dışında takas için..."
    },
    {
      "position": 9,
      "title": "Dünyanın En Büyük Bilişim Şirketi Apple... - onedio.com",
      "link": "https://onedio.com/haber/dunyanin-en-buyuk-bilisim-sirketi-apple-hakkinda-daha-once-duymadiginiz-20-gercek-756980",
      "displayed_link": "onedio.com›haber/dunyanin-en-buyuk-bilisim…apple…",
      "snippet": "8. Siri'ye söylediğiniz her şey Apple şirketine gönderilmekte, analiz edilmekte ve depolanmaktadır. 9. Apple şirketinin nakit akışı, ABD hazinesininkinden daha yüksektir."
    },
    {
      "position": 10,
      "title": "Apple Türkiye Online Store Açıldı! - Sihirli Elma",
      "link": "https://www.sihirlielma.com/2013/11/01/apple-turkiye-online-store-magaza-acildi/",
      "displayed_link": "sihirlielma.com›2013/11/01/apple-turkiye-online…",
      "snippet": "Apple’ın Türkiye web sitesi (www.apple.com/tr) hala güncelleniyor. ... Apple Online Store şimdi sizinle.” başlığıyla birlikte özel olarak hazırlanmış görsel dikkat çekiyor."
    }
  ],
}

Example using | (OR) operator

Note that lang have to be set to null to make the search work

Example using | (OR) operator

JSON Example

{
  ...
  "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: Coffeelang: 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.

Example results for text: Coffee, lang: ru,en

JSON Example

{
  "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": "Колумбия славится своим мягким и сбалансированным кофе. Это третий по величине производитель кофе в мире и второй по величине в Латинской Америке."
    },
  ...
  ],
...
}