Logo SearchApi

Yandex Videos API Documentation

GET   /api/v1/search?engine=yandex_videos
OpenAPI Initiative Download OpenAPI Spec

Yandex Videos API returns video search results with titles, source links, durations, channels, view counts, publication dates, and thumbnails. Exclude a source, choose a safe-search level, and request additional pages with page.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The terms to search for on Yandex Videos.

Localization

Filters

  • Name
    exclude_source
    Required
    Optional
    Description

    Exclude one video source: youtube, vk_video, kinopoisk, mail_ru, ok, rutube, dzen, or vimeo.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Page number from 1 to 50. Most queries run out of results before page 50, and pagination.next can still appear on the last page, so the next page can return the no-results error. Results can change between requests, so consecutive pages can repeat a video. Deduplicate by link. The number of videos varies by query and filters.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to yandex_videos.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Video Results

Video Results
GET
https://www.searchapi.org/api/v1/search?engine=yandex_videos&q=popular+videos
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "yandex_videos",
  "q": "popular videos"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_Q8LGJb0430ZbcGdgw59nyzNW",
    "status": "Success",
    "created_at": "2026-10-22T13:37:42Z",
    "request_time_taken": 1.83,
    "parsing_time_taken": 0.1,
    "total_time_taken": 1.93,
    "request_url": "https://yandex.com/video/search?text=popular+videos",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Q8LGJb0430ZbcGdgw59nyzNW.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Q8LGJb0430ZbcGdgw59nyzNW"
  },
  "search_parameters": {
    "engine": "yandex_videos",
    "q": "popular videos",
    "yandex_domain": "yandex.com"
  },
  "search_information": {
    "query_displayed": "popular videos"
  },
  "videos": [
    {
      "position": 1,
      "title": "Top 10 Best Choreographed Dance Music Videos",
      "link": "http://www.youtube.com/v/FfWNS_YakKw",
      "yandex_link": "https://yandex.com/video/preview/12610990406175729794",
      "snippet": "Top 10 Best Choreographed Dance Music Videos Subscribe: http://www.youtube.com/c/MsMojo?sub_c... A well choreographed music video is like a form of art. Not only are we focusing on the music but...",
      "length": "11:21",
      "length_seconds": 681,
      "source": "youtube.com",
      "channel": "MsMojo",
      "channel_link": "http://www.youtube.com/@MsMojo",
      "views": 9300000,
      "iso_date": "2017-02-17T00:00:00Z",
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/3847026/289d9689f86665f2998820ad516c03d4/564x318_1"
    },
    {
      "position": 2,
      "title": "The Weeknd, Madonna, Playboi Carti - Popular (Official Music Video)",
      "link": "http://www.youtube.com/live/vt0i6nuqNEo",
      "yandex_link": "https://yandex.com/video/preview/4304212834534506487",
      "snippet": "Music video by The Weeknd, Playboi Carti, Madonna performing Popular.© 2024 The Weeknd XO, Inc., marketed by Republic Records, a division of UMG Recordings, Inc...",
      "length": "3:51",
      "length_seconds": 231,
      "source": "youtube.com",
      "channel": "TheWeekndVEVO",
      "channel_link": "http://www.youtube.com/@TheWeekndVEVO",
      "views": 120700000,
      "iso_date": "2024-02-22T00:00:00Z",
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/3095331/946481c00c8191aea4bb225d004fa5b6/564x318_1"
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": "https://yandex.com/video/search?text=popular+videos&p=1"
  }
}

Family Mode

Family Mode
GET
https://www.searchapi.org/api/v1/search?engine=yandex_videos&q=cooking+pasta&safe_search=strict
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "yandex_videos",
  "q": "cooking pasta",
  "safe_search": "strict"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_YzO8NlMJg5M9UZ9gnBvQxXR0",
    "status": "Success",
    "created_at": "2026-10-22T13:37:45Z",
    "request_time_taken": 2.28,
    "parsing_time_taken": 0.07,
    "total_time_taken": 2.35,
    "request_url": "https://yandex.com/video/search?text=cooking+pasta&family=yes",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_YzO8NlMJg5M9UZ9gnBvQxXR0.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_YzO8NlMJg5M9UZ9gnBvQxXR0"
  },
  "search_parameters": {
    "engine": "yandex_videos",
    "q": "cooking pasta",
    "yandex_domain": "yandex.com",
    "safe_search": "strict"
  },
  "search_information": {
    "query_displayed": "cooking pasta"
  },
  "videos": [
    {
      "position": 1,
      "title": "How To Cook Pasta Properly ( Step by Step Pasta Cooking )",
      "link": "http://www.youtube.com/watch?v=OMRUIrbZDpM",
      "yandex_link": "https://yandex.com/video/preview/4915932741482106803",
      "snippet": "How To Cook Pasta Properly ( Step by Step Pasta Cooking ) Basic Cooking of Spaghetti Pasta or any type of Pasta. See Full Video here: How to Cook Spaghetti : • How To Cook Spaghetti - Pinoy...",
      "length": "3:34",
      "length_seconds": 214,
      "source": "youtube.com",
      "channel": "Friend-Cheap Menu",
      "channel_link": "http://www.youtube.com/@FriendCheapMenu",
      "views": 3300000,
      "iso_date": "2020-03-31T15:02:56Z",
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/3946675/506b1ce55270261aae5d9b2089bfe298/564x318_1"
    },
    {
      "position": 2,
      "title": "How To Cook Perfect Pasta - 4 Tips To Make The Best Pasta - How to cook spaghetti",
      "link": "http://www.youtube.com/watch?v=fAF88ThmBms",
      "yandex_link": "https://yandex.com/video/preview/1737409447275587145",
      "snippet": "I show how to cook pasta with 4 tips how to cook perfect pasta. Make the best pasta with my pasta cooking tips. I show how to cook pasta at home and how to cook pasta noodles. Cook perfect...",
      "length": "3:57",
      "length_seconds": 237,
      "source": "youtube.com",
      "channel": "Bobby Parrish",
      "channel_link": "http://www.youtube.com/@BobbyParrish",
      "views": 111000,
      "iso_date": "2016-09-16T00:00:00Z",
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/1534189/7111746a89cae200ae9d58daa55cc8cb/564x318_1"
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": "https://yandex.com/video/search?text=cooking+pasta&family=yes&p=1"
  }
}

Pagination

GET
https://www.searchapi.org/api/v1/search?engine=yandex_videos&page=2&q=cooking+pasta
Request
import requests

url = "https://www.searchapi.org/api/v1/search"
params = {
  "engine": "yandex_videos",
  "q": "cooking pasta",
  "page": "2"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_AEM9arelpd2kF6roW0Nw8nB5",
    "status": "Success",
    "created_at": "2026-10-22T13:48:35Z",
    "request_time_taken": 1.99,
    "parsing_time_taken": 0.1,
    "total_time_taken": 2.09,
    "request_url": "https://yandex.com/video/search?text=cooking+pasta&p=1",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_AEM9arelpd2kF6roW0Nw8nB5.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_AEM9arelpd2kF6roW0Nw8nB5"
  },
  "search_parameters": {
    "engine": "yandex_videos",
    "q": "cooking pasta",
    "yandex_domain": "yandex.com",
    "page": "2"
  },
  "search_information": {
    "query_displayed": "cooking pasta"
  },
  "videos": [
    {
      "position": 1,
      "title": "How To Cook Pasta The Right Way! | Kitchen Basics #2",
      "link": "http://www.youtube.com/watch?v=yyT6RP3h0CI",
      "yandex_link": "https://yandex.com/video/preview/9490212012772055055",
      "snippet": "Recently I saw a video of celebrity chef John Torode showing people how to cook pasta, and to be honest it had me shook! There was so much to say about his method, but in essence it was...",
      "length": "9:09",
      "length_seconds": 549,
      "source": "youtube.com",
      "channel": "Adam Garratt",
      "channel_link": "http://www.youtube.com/@Adam_Garratt",
      "views": 2500,
      "iso_date": "2024-12-15T00:00:00Z",
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/4554260/74cf6e883e26adea3e34b4207cc55fc0/564x318_1"
    },
    {
      "position": 2,
      "title": "Authentic-ish Italian Pasta Carbonara Recipe - Glen And Friends Cooking",
      "link": "http://www.youtube.com/watch?v=6qVwO1FvmJ0",
      "yandex_link": "https://yandex.com/video/preview/9700197781262048492",
      "snippet": "Pasta alla Carbonara is one of those very contentious recipes. People argue over method, and ingredients... We've tried to stay true to the original pasta alla carbonara recipe. But what is...",
      "length": "8:22",
      "length_seconds": 502,
      "source": "youtube.com",
      "channel": "Glen And Friends Cooking",
      "channel_link": "http://www.youtube.com/@GlenAndFriendsCooking",
      "views": 43300,
      "iso_date": "2019-10-12T00:00:00Z",
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/2771647/2a163532474f7bf687ffb733603d37d8/564x318_1"
    },
    "..."
  ],
  "pagination": {
    "current": 2,
    "previous": "https://yandex.com/video/search?text=cooking+pasta",
    "next": "https://yandex.com/video/search?text=cooking+pasta&p=2"
  }
}