Yahoo! Videos API

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

A user may query the following: https://serpapi.com/search?engine=yahoo_videos utilizing a GET request. Head to the playground for a live and interactive demo.

API Parameters

Search Query

p

Required

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

Localization

yahoo_domain

Optional

Parameter defines the Yahoo! domain to use. It defaults to search.yahoo.com. If specified domain is allowed, it will be prepended to the domain (e.g., fr.search.yahoo.com). You can check a full list of supported Yahoo! domains.

Advanced Yahoo Videos Parameters

durs

Optional

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

short - Short (less than 5 minutes)
medium - Medium (5-20 minutes)
long - Long (more than 20 minutes)

vage

Optional

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

day - Past 24 hours
week - Past week
month - Past month
year - Past year

vres

Optional

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

360p - 360p or higher
480p - 480p or higher
720p - 720p or higher
1080p - 1080p or higher

vsite

Optional

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

youtube - YouTube
dailymotion - Dailymotion
vimeo - Vimeo
mtv - MTV
cbsnews - CBS
foxnews - Fox
cnn - CNN
msn - MSN

Pagination

b

Optional

Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 1 (default) starts from the first result, 61 starts from the 61st result, 121 starts from the 121st result, etc.).

Serpapi Parameters

engine

Required

Set parameter to yahoo_videos to use the Yahoo! 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 Yahoo! 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 Yahoo! Videos.

API Examples

JSON structure overview

{
  ...
  "videos_results": [
    {
      "thumbnail": "String - URL to the video thumbnail",
      "link": "String - URL to the video",
      "original": "String - URL to the original upload of the video",
      "position": "Integer - Position of the video result"
      "title": "String - Title of the video result",
      "date": "String - Date of the video result",
      "source": "String - Source URL of the website containing the video result",
      "preview": "String - Preview URL of the video result",
      "duration": "String - Duration of the video result",
    }
  ],
  "ads": [
    {
      "link": "String - URL to the ad result",
      "position": "Integer - Position of the ad result"
      "title": "String - Title of the ad result",
      "source": "String - Source URL of the ad result",
      "description": "String - Description of the ad result",
    }
  ],
  ...
}

Example results for coffee

Videos results can contain thumbnail, link, title, original, source, preview, date, duration and position.

Example results for coffee

JSON Example

{
  "search_metadata": {
    "id": "634639329448930516683117",
    "status": "Success",
    "json_endpoint": "http://serpapi.com/searches/aa917719245564a3/634639329448930516683117.json",
    "created_at": "2022-10-12 03:49:06 UTC",
    "processed_at": "2022-10-12 03:49:07 UTC",
    "yahoo_videos_url": "https://video.search.yahoo.com/search/video?p=Coffee",
    "raw_html_file": "http://serpapi.com/searches/aa917719245564a3/634639329448930516683117.html",
    "total_time_taken": 2.51
  },
  "search_parameters": {
    "engine": "yahoo_videos",
    "p": "Coffee"
  },
  "videos_results": [
    {
      "thumbnail": "https://tse1.mm.bing.net/th?id=OVP.rIJGQkTaduQUs3blL-oIgAHgFo&pid=Api&h=360&w=480&c=7&rs=1",
      "link": "https://video.search.yahoo.com/video/play;_ylt=AwrEpIo1OUZjHs0fyIf7w8QF;_ylu=c2VjA3NyBHNsawN2aWQEZ3BvcwMx?p=Coffee&vid=1b1bdd242c2ff3bb81449666706579e8&turl=https%3A%2F%2Ftse1.mm.bing.net%2Fth%3Fid%3DOVP.rIJGQkTaduQUs3blL-oIgAHgFo%26pid%3DApi%26h%3D360%26w%3D480%26c%3D7%26rs%3D1&rurl=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DkKkwkWCeHAY&tit=3+ICED+COFFEES+That+are+Better+than+Starbucks+%7C+Delicious+Dupes&c=0&sigr=lEe0NvPJNWxW&sigt=.ONHUvXcUKAo&sigi=9qp1epKgzbV3&fr=p%3As%2Cv%3Av&h=360&w=480&l=310&age=1652021961&&tt=b",
      "original": "https://www.youtube.com/watch?v=kKkwkWCeHAY",
      "title": "3 ICED COFFEES That are Better than Starbucks | Delicious Dupes",
      "date": "5 months ago",
      "source": "youtube.com",
      "duration": "5:10",
      "preview": "https://tse4.mm.bing.net/th?id=OM.RDOvCJNbcP5hEA_1654645777&pid=Api",
      "position": 1
    },
    {
      "thumbnail": "https://tse1.mm.bing.net/th?id=OVP.1cdQY2FlYHkVzo6yDlo4MgHgFo&pid=Api&h=360&w=480&c=7&rs=1",
      "link": "https://video.search.yahoo.com/video/play;_ylt=AwrEpIo1OUZjHs0fyof7w8QF;_ylu=c2VjA3NyBHNsawN2aWQEZ3BvcwMy?p=Coffee&vid=473612559373bc372f30eaf21362f185&turl=https%3A%2F%2Ftse1.mm.bing.net%2Fth%3Fid%3DOVP.1cdQY2FlYHkVzo6yDlo4MgHgFo%26pid%3DApi%26h%3D360%26w%3D480%26c%3D7%26rs%3D1&rurl=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DO9YnLFrM7Fs&tit=A+Beginner%26%2339%3Bs+Guide+To+Buying+Great+%3Cb%3ECoffee%3C%2Fb%3E&c=1&sigr=7XxbqJTROmSW&sigt=vlIm3zmSIp76&sigi=tFIwg_VV2UFH&fr=p%3As%2Cv%3Av&h=360&w=480&l=1569&age=1621528739&&tt=b",
      "original": "https://www.youtube.com/watch?v=O9YnLFrM7Fs",
      "title": "A Beginner's Guide To Buying Great Coffee",
      "date": "1 year ago",
      "source": "youtube.com",
      "duration": "26:09",
      "preview": "https://tse1.mm.bing.net/th?id=OM1.G9FtgWsm8uaIrQ_1640513619&pid=Api",
      "position": 2
    },
    {
      "thumbnail": "https://tse4.mm.bing.net/th?id=OVP.KnIsW8waqvHbXREOZ4CbuQHgFo&pid=Api&h=360&w=480&c=7&rs=1",
      "link": "https://video.search.yahoo.com/video/play;_ylt=AwrEpIo1OUZjHs0fzIf7w8QF;_ylu=c2VjA3NyBHNsawN2aWQEZ3BvcwMz?p=Coffee&vid=47dcedd0245a66ddcddb2aac607edca7&turl=https%3A%2F%2Ftse4.mm.bing.net%2Fth%3Fid%3DOVP.KnIsW8waqvHbXREOZ4CbuQHgFo%26pid%3DApi%26h%3D360%26w%3D480%26c%3D7%26rs%3D1&rurl=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DpkbuFwHnJQY&tit=Kopi+Luwak%2FCivet+Poop+%3Cb%3ECoffee%3C%2Fb%3E%3A+Disgusting+or+Delightful%3F&c=2&sigr=INTLdq_T0AVL&sigt=Mrvt_OS3soAe&sigi=kCJkm3Vx3ov9&fr=p%3As%2Cv%3Av&h=360&w=480&l=556&age=1650636020&&tt=b",
      "original": "https://www.youtube.com/watch?v=pkbuFwHnJQY",
      "title": "Kopi Luwak/Civet Poop Coffee: Disgusting or Delightful?",
      "date": "5 months ago",
      "source": "youtube.com",
      "duration": "9:16",
      "preview": "https://tse4.mm.bing.net/th?id=OM1.IOxiGy_6JCh2LQ&pid=Api",
      "position": 3
    },
    ...
  ],
  "ads": [
    {
      "link": "https://www.bing.com/aclick?ld=e8RCqsbDKBMPsSWoSan13bbjVUCUy4aiLbZsdhc_8X7zaqP776jZC1vTAVNirpvyuy3IZ6FgNbGyX2jPwuZkRFgXUnQgSuTUCQJIRGFVtYdAekWHXuYbIdzwynsjDWP75aOnIBD_uIivuYeOBA0xaKNCQzrQUDRsrTbxv6EAwtHHwN0VYx6eJxaHbvViVJqfBYlpZPTA&u=aHR0cHMlM2ElMmYlMmZidXllcnNndWlkZS5vcmclMmZjb2ZmZWUtZ3JpbmRlciUyZnQlMmZidXJyJTNmbXNjbGtpZCUzZGUwNGE5NzI5NzlkOTEwYjg1MDM4ZjQ2ZjQwZWMzYmQwJTI2bSUzZGIlMjZkJTNkYyUyNmMlM2Q4MzU2MzI2MDE5NjI4NCUyNm9pZCUzZGt3ZC04MzU2MzkwNDc2ODcxNyUzYWxvYy00MTE2JTI2cXMlM2RDb2ZmZWUlMjZscCUzZDYwMTY1JTI2bGklM2QlMjZudyUzZG8lMjZudHMlM2QxJTI2dGRpZCUzZDk4MjE2NzA&rlid=e04a972979d910b85038f46f40ec3bd0",
      "title": "Top 10 Burr Coffee Grinders - Buyer's Guide Best Picks 2022",
      "source": "buyersguide.org",
      "description": "Compare the Best Burr Coffee Grinders Based on Price, Features, Ratings & Reviews. Read Expert Reviews & Find Best Sellers. Get 2-Day Shipping & Free Returns!",
      "position": 1
    },
    {
      "link": "https://www.bing.com/aclick?ld=e8QQ2YxyVKYSY7zFPlJ0coCjVUCUwyGmGB8xUgKYrYdo3Jf9NaoMjUouS6EBhyOwW5Y-icCp6Gj9ib785UihUcaqXvT07i4_0WOx_au0FWjcCyzdPxm3NL7YQ6583IgBpoNcIrRhznwcq4m4WuIpx0xs3q9z_OI2uSDkhGqzee3N-hDE2Uu_9hW_Owr2FB27plxS1K3Q&u=aHR0cHMlM2ElMmYlMmZ3d3cudWJlcmVhdHMuY29tJTJmZWwtcGFzbyUyZmZvb2QtZGVsaXZlcnklMmZnb29kLWNvZmZlZSUyZjVsNXUwcndWU2VhdWVERnl2SjNNWXclM2Z1dG1fc291cmNlJTNkQmluZ19Ob25CcmFuZCUyNnV0bV9jYW1wYWlnbiUzZENNMjA0OTI3NS1zZWFyY2gtYmluZy1ub25icmFuZF8xXy05OV9VUy1OYXRpb25hbF9lX2FsbF9hY3FfY3BhX2VuX1Jlc3RhdXJhbnRfQk1NXyUyNTJCZ29vZCUyNTIwJTI1MkJjb2ZmZWVfa3dkLTc2NDE2NDAxNTUzMjM5JTNhbG9jLTE5MF9fMTIyMjY1NzM3MDk1NDc4Ml9lX2MlMjZjYW1wYWlnbl9pZCUzZDM4MjQzNTkxOCUyNmFkZ19pZCUzZDEyMjI2NTczNzA5NTQ3ODIlMjZmaV9pZCUzZCUyNm1hdGNoJTNkZSUyNm5ldCUzZG8lMjZkZXYlM2RjJTI2ZGV2X20lM2QlMjZhZF9pZCUzZCUyNmNyZSUzZCUyNmt3aWQlM2Rrd2QtNzY0MTY0MDE1NTMyMzklM2Fsb2MtMTkwJTI2a3clM2QlMjUyQmdvb2QlMjUyMCUyNTJCY29mZmVlJTI2cGxhY2VtZW50JTNkJTI2dGFyJTNkJTI2Z2NsaWQlM2QxN2IzMzNiMmMzYzYxMGZhODNiNjUwZjRmYWYzNmY4YiUyNmdjbHNyYyUzZDNwLmRzJTI2JTI2bXNjbGtpZCUzZDE3YjMzM2IyYzNjNjEwZmE4M2I2NTBmNGZhZjM2Zjhi&rlid=17b333b2c3c610fa83b650f4faf36f8b",
      "title": "Good Coffee - Order Food to Your Door",
      "source": "www.ubereats.com",
      "description": "The Food You Love, Delivered. Go to Ubereats.com Now.",
      "position": 2
    },
    ...
  ],
  "serpapi_pagination": {
    "next": "https://serpapi.com/search.json?b=61&engine=yahoo_videos&p=Coffee",
    "current": "https://serpapi.com/search.json?engine=yahoo_videos&p=Coffee"
  }
}