Yandex Videos API

Our Yandex Videos API allows you to scrape SERP results from Yandex Videos. The API is accessed through the following endpoint: /search?engine=yandex_videos.

A user may query the following: https://serpapi.com/search?engine=yandex_videos utilizing a GET request. 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 Videos search.

Localization

yandex_domain

Optional

Parameter defines the Yandex Videos domain to use. It defaults to yandex.com. Head to the Yandex domains for a full list of supported Yandex domains.

Advanced Yandex Videos Parameters

duration

Optional

Parameter is used for filtering videos by duration. It can be set to:

short - Less than 10 minutes
medium - 10-65 minutes
long - More than 65 minutes

hd

Optional

Parameter is used for filtering videos by quality.

within

Optional

Parameter is used for showing recent videos.

Pagination

p

Optional

Parameter defines the page number. Pagination starts from 0, and it can return up to 30 results.

Serpapi Parameters

engine

Required

Set parameter to yandex_videos to use the Yandex Videos API engine.

device

Optional

Parameter defines the device to use to get the results. It can be set to desktop (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or mobile to use a mobile browser (currently using iPhones).

no_cache

Optional

Parameter will force SerpApi to fetch the Yandex Videos 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_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 videos results.

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 Videos.

API Examples

JSON structure overview

{
  ...
  "videos_results": [
    {
      "position": "Integer - Position of the video result",
      "thumbnail": "String - URL to the video thumbnail",
      "title": "String - Title of the video result",
      "date": "String - Date of the video result",
      "views": "String - Views of the video result",
      "original": "String - URL to the original upload of the video result",
      "source": "String - Source of the video result",
      "duration": "String - Duration of the video result",
      "resolution": "String - Resolution of the video result",
      "preview": {
        "url": "String - Preview URL of the video result",
        "type": "String - Type of the preview video result",
      },
      "channel": {
        "name": "String - Name of the channel",
        "link": "String - URL of the channel",
        "verified": "Boolean - True if the channel is verified",
      },
    },
    ...
  ],
  ...
}

Example results for Coffee

Videos results can contain position, thumbnail, preview, title, channel, date, views, original, duration, source, resolution and more.

Example results for Coffee

JSON Example

{
  "search_metadata": {
    "id": "660ab418de9834198318aea4",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/26e57ba27c5130d1/660ab418de9834198318aea4.json",
    "created_at": "2024-04-01 13:18:16 UTC",
    "processed_at": "2024-04-01 13:18:16 UTC",
    "yandex_videos_url": "https://yandex.com/video/search?text=coffee",
    "raw_html_file": "https://serpapi.com/searches/26e57ba27c5130d1/660ab418de9834198318aea4.html",
    "total_time_taken": 1.61
  },
  "search_parameters": {
    "engine": "yandex_videos",
    "text": "coffee",
    "device": "desktop"
  },
  "videos_results": [
    {
      "position": 1,
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/2772863/bf0b24207159b1bc1738e4de3cbaacef/564x318_1",
      "preview": {
        "url": "https://video-preview.s3.yandex.net/dJxI9wEAAAA.mp4",
        "type": "video/mp4"
      },
      "title": "Coffee coffee coffee coffee coffee coffee coffee coffee coffee coffee coffee coffee...",
      "date": "3 Mar 2022",
      "views": "2,3M",
      "original": "http://www.youtube.com/watch?v=FZBffDupBw0",
      "source": "YouTube",
      "duration": "1:57",
      "channel": {
        "name": "ExplosmEntertainment",
        "link": "http://www.youtube.com/@ExplosmEntertainment",
        "verified": true
      }
    },
    {
      "position": 2,
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/403953/5d5a88f807d6a0a091af99dba79c2c88/564x318_1",
      "preview": {
        "url": "https://video-preview.s3.yandex.net/d_k_aQAAAAA.mp4",
        "type": "video/mp4"
      },
      "title": "Coffee Chocolate",
      "date": "31 Mar 2016",
      "views": "132,5K",
      "original": "http://www.youtube.com/watch?v=YewV9ajGC24",
      "source": "YouTube",
      "duration": "2:07",
      "resolution": "FullHD",
      "channel": {
        "name": "emmymadeinjapan",
        "link": "http://www.youtube.com/user/emmymadeinjapan",
        "verified": true
      }
    },
    {
      "position": 3,
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/2918671/241abda7972c0d943e74b7d150139502/564x318_1",
      "preview": {
        "url": "https://video-preview.s3.yandex.net/WFrDQwIAAAA.mp4",
        "type": "video/mp4"
      },
      "title": "Coffee Menu Explained What the most common coffees are and how to make them",
      "date": "15 Jul 2021",
      "views": "1,6M",
      "original": "http://www.youtube.com/watch?v=rLaVDQy0q8Y",
      "source": "YouTube",
      "duration": "16:48",
      "channel": {
        "name": "Artisti Coffee Roasters.",
        "link": "http://www.youtube.com/@ArtistiCoffeeRoasters"
      }
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?device=desktop&engine=yandex_videos&p=1&text=coffee",
    "current": "https://serpapi.com/search.json?device=desktop&engine=yandex_videos&text=coffee"
  }
}