Yahoo Videos API Documentation

GET   /api/v1/search?engine=yahoo_videos

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.com defines the Yahoo domain of the search. Each domain searches its own market, so results differ between domains. Check the full list of supported Yahoo Videos yahoo_domain domains.

Filters

  • Name
    safe
    Required
    Optional
    Description

    Specifies the filter level for adult content. Available values are:

    • on Default
    • 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_day
    • last_week
    • last_month
    • last_year

  • Name
    quality
    Required
    Optional
    Description

    Filters videos by minimum resolution. Available values are:

    • 360p_or_higher
    • 480p_or_higher
    • 720p_or_higher
    • 1080p_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 from 1 to 4 are 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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=how+to+tie+a+tie
Request
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)
Response
{
  "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

Duration and Quality Filters
GET
https://www.searchapi.io/api/v1/search?duration=long&engine=yahoo_videos&q=guitar+lesson&quality=1080p_or_higher
Request
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)
Response
{
  "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

Source and Upload Time
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=space+x+launch&source=youtube&time_period=last_month
Request
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)
Response
{
  "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

GET
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=office+chair
Request
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)
Response
{
  "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
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&q=pasta+recipe
Request
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)
Response
{
  "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

Regional Results and Pagination
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_videos&page=2&q=eiffel+tower&yahoo_domain=de.search.yahoo.com
Request
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)
Response
{
  "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.