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.

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",
      "description": "String - Description 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",
      },
    },
    ...
  ],
  ...
}

Example results for Coffee

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

Example results for Coffee

JSON Example

{
  "search_metadata": {
    "id": "632d901c9448931a96b2a19f",
    "status": "Success",
    "json_endpoint": "https://serpapi.com/searches/95e632e7b0e7836c/632d901c9448931a96b2a19f.json",
    "created_at": "2022-09-23 10:53:16 UTC",
    "processed_at": "2022-09-23 10:53:16 UTC",
    "yandex_videos_url": "https://yandex.com/video/search?text=Coffee",
    "raw_html_file": "https://serpapi.com/searches/95e632e7b0e7836c/632d901c9448931a96b2a19f.html",
    "total_time_taken": 3.45
  },
  "search_parameters": {
    "engine": "yandex_videos",
    "text": "Coffee",
    "device": "desktop"
  },
  "videos_results": [
    {
      "position": 1,
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/3924933/1072f2e40b4a42556dd33692364209af/564x318_1",
      "preview": {
        "url": "https://video-preview.s3.yandex.net/A7MzGwEAAAA.mp4",
        "type": "video/mp4"
      },
      "title": "Incommon Coffee - Slow Coffee",
      "description": "Reflections on the importance of taking the time to brew a good cup of coffee. Made for Incommon Coffee featuring Trent Rollings! https://www.incommon.coffee Director: Michael Rothermel...",
      "views": "9230 views",
      "date": "28 February 2020",
      "original": "http://vimeo.com/394456176",
      "source": "vimeo.com",
      "duration": "02:37"
    },
    {
      "position": 2,
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/3905148/e6e0f89af66dd0c69a42b0f74a05800a/564x318_1",
      "preview": {
        "url": "https://video-preview.s3.yandex.net/6VDmEAAAAAA.mp4",
        "type": "video/mp4"
      },
      "title": "Coffee Beans in #essey Kaprika Media",
      "description": "A personal project the Colorbleed team worked on the last few weeks. Software used: Maya Zbrush V-ray Fusion Photoshop Music: Chris Zabriskie - The Temperature of the Air on the Bow of the...",
      "views": "81 thsd. views",
      "date": "23 December 2013",
      "original": "http://vimeo.com/82547176",
      "source": "vimeo.com",
      "duration": "01:04",
      "resolution": "FullHD"
    },
    {
      "position": 3,
      "thumbnail": "https://avatars.mds.yandex.net/get-vthumb/930548/3bd09436358f39ca1e8a3d0d6a50a7a8/564x318_1",
      "preview": {
        "url": "https://video-preview.s3.yandex.net/ziOrGgAAAAA.mp4",
        "type": "video/mp4"
      },
      "title": "Bigfoot Coffee Shop in coffee",
      "description": "<iframe src='https://player.vimeo.com/video/79380000' width='640' height='0' frameborder='0' allow='autoplay; fullscreen' allowfullscreen title=&qu...",
      "views": "7752 views",
      "date": "14 November 2013",
      "original": "http://vimeo.com/79380000",
      "source": "vimeo.com",
      "duration": "02:53"
    },
    ...
  ],
  "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"
  }
}