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
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 hoursweek
- Past weekmonth
- Past monthyear
- Past year
Serpapi Parameters
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 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
.
{
"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"
}
}