Yahoo Videos API Documentation
Search Yahoo Videos and retrieve video titles, watch page links, embeddable player links, descriptions, source sites, lengths, view counts, thumbnails, related searches, and shopping ads when present as structured JSON, 60 videos per page.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
This parameter is used for the terms you want to search on Yahoo Videos.
Localization
-
- Name
-
yahoo_domain - Required
- Optional
- Description
-
The default parameter
search.yahoo.comdefines the Yahoo domain of the search. Each domain searches its own market, so results differ between domains. Check the full list of supported Yahoo Videosyahoo_domaindomains.
Filters
-
- Name
-
safe - Required
- Optional
- Description
-
Specifies the filter level for adult content. Available values are:
-
onDefault off
-
-
- Name
-
duration - Required
- Optional
- Description
-
Filters videos by length. Available values are:
short- under 5 minutes.medium- 5 to 20 minutes.long- over 20 minutes.
-
- Name
-
time_period - Required
- Optional
- Description
-
Filters videos by how recently they were published. Available values are:
last_daylast_weeklast_monthlast_year
-
- Name
-
quality - Required
- Optional
- Description
-
Filters videos by minimum resolution. Available values are:
360p_or_higher480p_or_higher720p_or_higher1080p_or_higher
-
- Name
-
source - Required
- Optional
- Description
-
Returns only videos from one site. Available values are:
youtube- YouTube.dailymotion- Dailymotion.vimeo- Vimeo.cbs- CBS News.fox- Fox News.cnn- CNN.msn- MSN.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
This parameter indicates which page of results to return, with up to 60 videos per page. By default, it is set to
1. Yahoo Videos shows at most 4 pages, so values from1to4are accepted. A page past the last one returns an error.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
yahoo_videos.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates 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
trueto 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
Full Response
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=how+to+tie+a+tie
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "yahoo_videos",
"q": "how to tie a tie"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_nbd4FSt2I9ZTqdMnPN4oU53t",
"status": "Success",
"created_at": "2026-11-12T14:30:22Z",
"request_time_taken": 1.56,
"parsing_time_taken": 0.03,
"total_time_taken": 1.59,
"request_url": "https://video.search.yahoo.com/search/video?p=how+to+tie+a+tie&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_nbd4FSt2I9ZTqdMnPN4oU53t.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_nbd4FSt2I9ZTqdMnPN4oU53t"
},
"search_parameters": {
"engine": "yahoo_videos",
"q": "how to tie a tie",
"yahoo_domain": "search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "how to tie a tie"
},
"videos": [
{
"position": 1,
"title": "How to tie a tie EASY WAY (Slowly & Mirrored) Windsor knot",
"link": "https://www.youtube.com/watch?v=4fHMbXWcoq0",
"video_link": "https://www.youtube.com/embed/4fHMbXWcoq0?autoplay=0&wmode=transparent&origin=https://video.search.y...",
"snippet": "How to tie a tie easy way instruction! If you want to tie your tie quick and easy please watch my step by step tutorial. In this video you will learn most popular necktie knot in the world - Windsor knot. Good luck for everyone!",
"source": "YouTube",
"length": "03:33",
"views": 53400000,
"thumbnail": "https://up.yimg.com/ib/th/id/OVP.WH04-oWA07B2A8pEJ-W46wHgFo?pid=Api&h=360&w=480&c=7&rs=1&qlt=95"
},
"..."
],
"related_searches": [
{
"query": "How Do You Tie a Tie",
"link": "https://video.search.yahoo.com/search/video?p=How+Do+You+Tie+a+Tie",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/pJ1u4rjbRcM11t0zWmjH3w--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05Njt3PTk..."
},
"..."
],
"pagination": {
"current": 1,
"next": "https://video.search.yahoo.com/search/video?vm=r&p=how+to+tie+a+tie&b=61"
}
}
The videos array holds the results in page order. Each video has a link to the page where it plays,
the source site that hosts it, and a thumbnail. video_link is the embeddable player,
and views is the view count as a number. Both are left out when the source site does not provide them, as
MSN and news sites often do not. length is the time Yahoo displays in minutes and seconds. Yahoo omits
hours, so a video lasting 2:25:19 shows 25:19. related_searches are the related queries shown above the results. Pass a
related search query back as q to follow it.
pagination.next is present while Yahoo has more results. Yahoo Videos returns up to about 200 videos for a
query, so most queries end on page 2, 3 or 4. Request the next page with the page parameter. A page past the
last one returns HTTP 200 with error: "Yahoo Videos has no more results for the requested page.",
and a query with no results returns error: "Yahoo Videos did not return any results."
Duration and Quality Filters
https://www.searchapi.io/api/v1/search?duration=long&engine=yahoo_videos&q=guitar+lesson&quality=1080p_or_higher
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "yahoo_videos",
"q": "guitar lesson",
"duration": "long",
"quality": "1080p_or_higher"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_ClAdzKskEHHuq5gvh3PDwq4p",
"status": "Success",
"created_at": "2026-11-12T14:29:49Z",
"request_time_taken": 1.64,
"parsing_time_taken": 0.0,
"total_time_taken": 1.65,
"request_url": "https://video.search.yahoo.com/search/video?p=guitar+lesson&vm=r&durs=long&vres=1080p",
"html_url": "https://www.searchapi.io/api/v1/searches/search_ClAdzKskEHHuq5gvh3PDwq4p.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_ClAdzKskEHHuq5gvh3PDwq4p"
},
"search_parameters": {
"engine": "yahoo_videos",
"q": "guitar lesson",
"yahoo_domain": "search.yahoo.com",
"safe": "on",
"duration": "long",
"quality": "1080p_or_higher"
},
"search_information": {
"query_displayed": "guitar lesson"
},
"videos": [
{
"position": 1,
"title": "How to Learn a Complete Song from Beginning to End",
"link": "https://www.youtube.com/watch?v=uTqITWWS0J8",
"video_link": "https://www.youtube.com/embed/uTqITWWS0J8?autoplay=0&wmode=transparent&origin=https://video.search.y...",
"snippet": "🔥 Marin Music Merch is available NOW at marinmusic.com! Shirts, Hoodies, Stickers, and Guitar Picks! ️ https://marinmusic.com Sign up for my newsletter and get access to two FREE video courses: 🎸 11 Essential Tips for Every Guitarist 💪 Mastering Barre Chords You’ll also get my weekly tutorial release calendar, behind-the-scenes ...",
"source": "YouTube",
"length": "22:58",
"views": 23200,
"thumbnail": "https://up.yimg.com/ib/th/id/OVP.PtDVG1xeBR000LsT0h42bwHgFo?pid=Api&h=360&w=480&c=7&rs=1&qlt=95"
},
"..."
]
}
Source and Upload Time
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=space+x+launch&source=youtube&time_period=last_month
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "yahoo_videos",
"q": "space x launch",
"source": "youtube",
"time_period": "last_month"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_0TCW7QoJav9zY8KwDyLjA9VS",
"status": "Success",
"created_at": "2026-11-12T14:29:51Z",
"request_time_taken": 2.7,
"parsing_time_taken": 0.0,
"total_time_taken": 2.71,
"request_url": "https://video.search.yahoo.com/search/video?p=space+x+launch&vm=r&vage=month&vsite=youtube",
"html_url": "https://www.searchapi.io/api/v1/searches/search_0TCW7QoJav9zY8KwDyLjA9VS.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_0TCW7QoJav9zY8KwDyLjA9VS"
},
"search_parameters": {
"engine": "yahoo_videos",
"q": "space x launch",
"yahoo_domain": "search.yahoo.com",
"safe": "on",
"time_period": "last_month",
"source": "youtube"
},
"search_information": {
"query_displayed": "space x launch"
},
"videos": [
{
"position": 1,
"title": "Starship - Go For Orbit",
"link": "https://www.youtube.com/watch?v=8ySMdUIF3cY",
"video_link": "https://www.youtube.com/embed/8ySMdUIF3cY?autoplay=0&wmode=transparent&origin=https://video.search.y...",
"snippet": "More than a dozen flight tests and years of development, with countless hours worked by SpaceX engineers and technicians, all come down to this: the first orbital Starship launch carrying advanced Starlink satellites bound for space. Watch “Go For Orbit” and experience the moments behind flying the most ambitious Starship mission yet ...",
"source": "YouTube",
"length": "21:10",
"views": 2900000,
"thumbnail": "https://up.yimg.com/ib/th/id/OVF.JwKckF8j7B4FolQUXNmF7w?pid=Api&h=360&w=480&c=7&rs=1&qlt=95"
},
"..."
]
}
Shopping Ads
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=office+chair
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "yahoo_videos",
"q": "office chair"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_parameters": {
"engine": "yahoo_videos",
"q": "office chair",
"yahoo_domain": "search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "office chair"
},
"shopping_ads": [
{
"position": 1,
"title": "NOUHAUS Posture Ergonomic PU Leather Office Chair, Flat Black",
"seller": "Nouhaus",
"link": "https://www.nouhaus.com/products/posture?variant=31451715043362&utm_medium=cpc&utm_source=bing&utm_campaign=Bing%20Shopping&country=US&msclkid=7ac5a5ba3dc11dadd8b3cf4d733fce53&utm_term=4581115217898803&utm_content=Ad%20group%20%231",
"price": "$309.99",
"extracted_price": 309.99,
"image": "https://sp.yimg.com/ib/th?id=OPHS.T0AM7u5Hn6UJuQ474C474&o=5&pid=21.1&w=174&h=174"
},
"..."
],
"videos": [
{
"position": 1,
"title": "7 Levels of Office Chairs",
"link": "https://www.youtube.com/watch?v=r1cB7nCmR08",
"video_link": "https://www.youtube.com/embed/r1cB7nCmR08?autoplay=0&wmode=transparent&origin=https://video.search.yahoo.com&html5=1&enablejsapi=1",
"snippet": "*15% OFF BLACK FRIDAY SALE on Steelcase Chairs & MORE Ends 11/27!* https://btodtv.com/3S2HqLR *Office Chair Cheat Sheet* https://btodtv.com/4g4qIna Stop making expensive mistakes on your office chair journey. In this video, we break down all seven levels of office chairs, from $80 budget options to high-end flagship models. Watch to see which ...",
"source": "YouTube",
"length": "08:22",
"views": 40400,
"thumbnail": "https://up.yimg.com/ib/th/id/OVP.rPkfEgLBcWRs202EI3ByhAEsDh?pid=Api&h=225&w=300&c=7&rs=1&qlt=95"
},
"..."
],
"related_searches": [
{
"query": "Assembling Office Chair",
"link": "https://video.search.yahoo.com/search/video?p=Assembling+Office+Chair",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/6NPaaW865oBZkU2VTnEFfg--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05Njt3PTk2/https://tse3.mm.bing.net/th?q=Assembling+Office+Chair&pid=Api&mkt=en-US&cc=US&setlang=en&adlt=strict&t=1"
},
"..."
],
"pagination": {
"current": 1,
"next": "https://video.search.yahoo.com/search/video?vm=r&p=office+chair&b=61"
}
}
Product searches can include shopping_ads alongside the videos. Each product has its title, seller,
price as displayed, numeric extracted_price, image, and a link to the store. Repeated placements of
the same product appear once, in source order. The field is absent when Yahoo shows no shopping cards.
Related Searches
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=pasta+recipe
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "yahoo_videos",
"q": "pasta recipe"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_lPa3VyuuaJR3Yw1DAkjehPqT",
"status": "Success",
"created_at": "2026-11-12T14:29:54Z",
"request_time_taken": 1.47,
"parsing_time_taken": 0.0,
"total_time_taken": 1.47,
"request_url": "https://video.search.yahoo.com/search/video?p=pasta+recipe&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_lPa3VyuuaJR3Yw1DAkjehPqT.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_lPa3VyuuaJR3Yw1DAkjehPqT"
},
"search_parameters": {
"engine": "yahoo_videos",
"q": "pasta recipe",
"yahoo_domain": "search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "pasta recipe"
},
"related_searches": [
{
"query": "Best Pasta Recipes",
"link": "https://video.search.yahoo.com/search/video?p=Best+Pasta+Recipes",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/6emGGwtfXIkibkgBG6Tp3A--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05Njt3PTk..."
},
"..."
]
}
Regional Results and Pagination
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&page=2&q=eiffel+tower&yahoo_domain=de.search.yahoo.com
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "yahoo_videos",
"q": "eiffel tower",
"yahoo_domain": "de.search.yahoo.com",
"page": 2
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_tBwuB99DPr5WwiGG6IQhb3CY",
"status": "Success",
"created_at": "2026-11-12T14:33:37Z",
"request_time_taken": 2.03,
"parsing_time_taken": 0.0,
"total_time_taken": 2.03,
"request_url": "https://de.video.search.yahoo.com/search/video?p=eiffel+tower&vm=r&b=61",
"html_url": "https://www.searchapi.io/api/v1/searches/search_tBwuB99DPr5WwiGG6IQhb3CY.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_tBwuB99DPr5WwiGG6IQhb3CY"
},
"search_parameters": {
"engine": "yahoo_videos",
"q": "eiffel tower",
"yahoo_domain": "de.search.yahoo.com",
"safe": "on",
"page": 2
},
"search_information": {
"query_displayed": "eiffel tower"
},
"videos": [
{
"position": 1,
"title": "Eiffel Tower Tour - Level 1, 2 & 3 - With Captions!",
"link": "https://www.youtube.com/watch?v=Lrj8LEZ9FA4",
"video_link": "https://www.youtube.com/embed/Lrj8LEZ9FA4?autoplay=0&wmode=transparent&origin=https://de.video.searc...",
"snippet": "This tour of Eiffel Tour was filmed on Sunday, July 19th, 2020 starting at 4:28 PM at the Champ de Mars. You will take lift up to Level 2 and then up the top where you will get beautiful views of Paris in all directions. For the best experience, be sure to turn on closed captions [CC] and wear headphones 🎧 as you watch this tour ...",
"source": "YouTube",
"length": "52:45",
"views": 190700,
"thumbnail": "https://up.yimg.com/ib/th/id/OVP.PC6IMvBVnMmPBKQE5fwJhgHgFo?pid=Api&h=360&w=480&c=7&rs=1&qlt=95"
},
"..."
],
"pagination": {
"current": 2
}
}
Related searches appear on search.yahoo.com and are usually absent on other domains.