Yahoo News API Documentation
Search Yahoo News and retrieve article titles, links, publishers, dates, snippets, thumbnails and publisher favicons as structured JSON, 10 articles per page, along with the ads, knowledge graph, related searches and trending searches Yahoo shows next to them.
API Parameters
Search Query
-
- Name
-
q - Required
- Required
- Description
-
This parameter is used for the terms you want to search on Yahoo News. Queries can include quoted phrases and the
site:operator, for examplesite:reuters.com tesla.
Localization
-
- Name
-
yahoo_domain - Required
- Optional
- Description
-
The default parameter
search.yahoo.comdefines the Yahoo domain of the search. Each domain searches its own regional news edition, in its own language, so results differ between domains. Check the full list of supported Yahoo Newsyahoo_domaindomains.
Sorting
-
- Name
-
sort_by - Required
- Optional
- Description
-
Sorts the articles. By default they are sorted by relevance. Available values are:
most_recent- newest articles first.
Filters
-
- Name
-
time_period - Required
- Optional
- Description
-
Limits the articles to a time window. Without it, Yahoo News returns articles from about the past week. Available values are:
last_daylast_weeklast_month
-
- Name
-
safe - Required
- Optional
- Description
-
Specifies the filter level for adult content. With
on, a query with restricted words returns no results. Available values are:-
onDefault moderateoff
-
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
This parameter indicates which page of results to return, with 10 articles per page. By default, it is set to
1, and the highest page is100. 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_news.
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_news&q=openai
- 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_news",
"q": "openai"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_nU2a6MCOOFAtAUhC9zJE1PVk",
"status": "Success",
"created_at": "2026-11-12T14:39:35Z",
"request_time_taken": 1.23,
"parsing_time_taken": 0.11,
"total_time_taken": 1.34,
"request_url": "https://news.search.yahoo.com/news/search?p=openai&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_nU2a6MCOOFAtAUhC9zJE1PVk.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_nU2a6MCOOFAtAUhC9zJE1PVk"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "openai",
"yahoo_domain": "search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "openai",
"total_results": 1953
},
"organic_results": [
{
"position": 8,
"title": "AMD Is the Real Loser in OpenAI’s Cash Burn: Up to 6 Gigawatts Ride on It",
"link": "https://finance.yahoo.com/markets/stocks/articles/amd-real-loser-openai-cash-050109302.html?fr=sycsr...",
"source": "TIKR",
"via": "Yahoo Finance",
"date": "10 hours ago",
"snippet": "Key Takeaways OpenAI’s third-quarter revenue rose nearly 50% to $10 billion, but its adjusted operat...",
"favicon": "https://s.yimg.com/pv/static/search_favicon/images/32x32_609870dede9a8a04_1771752856.png",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/907VtrEeMVEImZ8kr60lpg--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD0xMDY7cHh..."
},
"..."
],
"related_searches": [
{
"query": "openai chat gpt",
"link": "https://news.search.yahoo.com/news/search;_ylt=A2RRY6Ooz_VqwwIAErTQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9..."
},
"..."
],
"trending_searches": [
{
"title": "Jensen Huang",
"snippet": "Nvidia CEO Jensen Huang and Kimberly Powell's affair rumours spark meme frenzy",
"link": "https://search.yahoo.com/search;_ylt=A2RRY6Ooz_VqwwIAH7TQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9zAzEEdnRpZ...",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/Zj_HFgEOBw5zjBBkx45AAg--~C/YXBwaWQ9c3JjaGRkO2ZpPXN0cmltO2g9MTYwO3E..."
},
"..."
],
"pagination": {
"current": 1,
"next": "https://news.search.yahoo.com/news/search;_ylt=A2RRY6Ooz_VqwwIAHrTQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"other_pages": {
"2": "https://news.search.yahoo.com/news/search;_ylt=A2RRY6Ooz_VqwwIAGrTQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"3": "https://news.search.yahoo.com/news/search;_ylt=A2RRY6Ooz_VqwwIAG7TQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"4": "https://news.search.yahoo.com/news/search;_ylt=A2RRY6Ooz_VqwwIAHLTQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"5": "https://news.search.yahoo.com/news/search;_ylt=A2RRY6Ooz_VqwwIAHbTQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9..."
}
}
}
The organic_results array holds the articles in page order. Each article has its title,
link and date, and usually a source, snippet and thumbnail.
When Yahoo shortens a long headline on the page, title carries the whole headline when the page holds it. When an article was
republished on a Yahoo property such as Yahoo Finance, via names that property and link points
to the Yahoo copy. date is the article's age exactly as Yahoo prints it, such as 2 hours ago,
in the language of the edition.
search_information.total_results is the approximate count Yahoo reports, which can change from page to page.
A query with no results, or a restricted word with safe set to on, returns HTTP 200
with error: "Yahoo News did not return any results."
Time Period and Sort
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=nvidia&sort_by=most_recent&time_period=last_day
- 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_news",
"q": "nvidia",
"time_period": "last_day",
"sort_by": "most_recent"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_a8rXrsFvC8tp9oIoz11aWgmu",
"status": "Success",
"created_at": "2026-11-12T14:39:37Z",
"request_time_taken": 1.28,
"parsing_time_taken": 0.0,
"total_time_taken": 1.28,
"request_url": "https://news.search.yahoo.com/news/search?p=nvidia&vm=r&btf=d&fr2=sortBy&context=gsmcontext%3A%3Asor...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_a8rXrsFvC8tp9oIoz11aWgmu.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_a8rXrsFvC8tp9oIoz11aWgmu"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "nvidia",
"yahoo_domain": "search.yahoo.com",
"time_period": "last_day",
"sort_by": "most_recent",
"safe": "on"
},
"search_information": {
"query_displayed": "nvidia",
"total_results": 1699
},
"organic_results": [
{
"position": 1,
"title": "He Wants AI to Pick Winning Stocks for His $200,000 401(k). A 0.75% Fee Could Cost Him $1,400 More a Year Than a Low-Cost Fund. He’ll Pay the...",
"link": "https://finance.yahoo.com/markets/options/articles/wants-ai-pick-winning-stocks-143125873.html?fr=sy...",
"source": "24/7 Wall St.",
"via": "Yahoo Finance",
"date": "8 minutes ago",
"snippet": "A 57-year-old wants software to pick the winners in his 401(k), but the fund collects its fee...",
"favicon": "https://s.yimg.com/pv/static/search_favicon/images/32x32_5174185651b0be54.png",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/0SdT4Tg0ZRY2LfXrt58M1w--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD0xMDY7cHh..."
},
"..."
]
}
Without time_period, Yahoo News returns articles from about the past week, the same window as
last_week. last_month is the widest window Yahoo News offers.
Regional Edition
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=futebol&yahoo_domain=br.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_news",
"q": "futebol",
"yahoo_domain": "br.search.yahoo.com"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_sXRxcE9cw6zQ0wCO15sbpxc1",
"status": "Success",
"created_at": "2026-11-12T14:40:43Z",
"request_time_taken": 1.35,
"parsing_time_taken": 0.1,
"total_time_taken": 1.46,
"request_url": "https://br.news.search.yahoo.com/news/search?p=futebol&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_sXRxcE9cw6zQ0wCO15sbpxc1.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_sXRxcE9cw6zQ0wCO15sbpxc1"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "futebol",
"yahoo_domain": "br.search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "futebol",
"total_results": 2404
},
"organic_results": [
{
"position": 1,
"title": "Vasco recebe sondagens do futebol inglês por Andrés Gómez",
"link": "https://www.terra.com.br/esportes/vasco/vasco-recebe-sondagens-do-futebol-ingles-por-andres-gomez,26...",
"source": "Terra Notícias",
"date": "46 minutos atrás",
"snippet": "Cruz-Maltino espera receber entre R$ 93 milhões e R$ 124 milhões para negociar o atacante colombiano",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/jdtFQKwL3YWGIBkGrYLn5w--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD05MjtweG9..."
},
"..."
]
}
Ads
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=premier+league&yahoo_domain=uk.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_news",
"q": "premier league",
"yahoo_domain": "uk.search.yahoo.com"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_T1Vi02dtoVoprqTg4wjH4sug",
"status": "Success",
"created_at": "2026-11-12T14:39:39Z",
"request_time_taken": 1.53,
"parsing_time_taken": 0.01,
"total_time_taken": 1.53,
"request_url": "https://uk.news.search.yahoo.com/news/search?p=premier+league&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_T1Vi02dtoVoprqTg4wjH4sug.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_T1Vi02dtoVoprqTg4wjH4sug"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "premier league",
"yahoo_domain": "uk.search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "premier league",
"total_results": 3666
},
"ads": [
{
"position": 1,
"block_position": "top",
"title": "Premier League Tickets - Premier League Match Tickets",
"link": "https://seatpick.com/english-premier-league-tickets?utm_source=bing&utm_medium=cpc&utm_campaign=5251...",
"displayed_link": "seatpick.com",
"snippet": "Trusted by 30M+ fans. See all upcoming Premier League matches and compare prices. Seller guarantees apply. Find the best price and pick your seats in a few clicks.",
"sitelinks": {
"inline": [
{
"title": "Why Trust SeatPick",
"link": "https://seatpick.com/guarantee?utm_source=bing&utm_medium=cpc&utm_campaign=525184146&utm_content=132..."
},
"..."
]
}
},
"..."
]
}
Knowledge Graph
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=veterans+day
- 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_news",
"q": "veterans day"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_r79zhoyOyM2KZPq59IJcWC2A",
"status": "Success",
"created_at": "2026-11-12T14:39:41Z",
"request_time_taken": 3.4,
"parsing_time_taken": 0.0,
"total_time_taken": 3.41,
"request_url": "https://news.search.yahoo.com/news/search?p=veterans+day&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_r79zhoyOyM2KZPq59IJcWC2A.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_r79zhoyOyM2KZPq59IJcWC2A"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "veterans day",
"yahoo_domain": "search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "veterans day",
"total_results": 6306
},
"knowledge_graph": {
"title": "Veterans Day",
"subtitle": "National holiday",
"description": "Veterans Day (originally known as Armistice Day) is a federal holiday in the United States observed annually on November 11, for honoring military veterans, that is, persons who have served in the U.S. Armed Forces. Wikipedia",
"source": "https://en.wikipedia.org/wiki/Veterans_Day",
"date": "November 11",
"also_called": "Armistice Day",
"celebrations": "Veterans Day parades",
"frequency": "Annual",
"related_to": "Remembrance Day",
"related_to_links": [
{
"text": "Remembrance Day",
"link": "https://news.search.yahoo.com/news/search;_ylt=A2RRa2iuz_Vq6FkJXoHQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9..."
},
"..."
],
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/Ed2O2ujxkZ6_.p3cKQiq9A--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD0yNDA7cT0...",
"people_also_search_for": [
{
"query": "Dept. of Veterans Affairs",
"link": "https://news.search.yahoo.com/news/search;_ylt=A2RRa2iuz_Vq6FkJX4HQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/K5uUFrG2QG4HuWQ7ExwLfA--~C/YXBwaWQ9c3JjaGRkO2ZpPWZpbGw7aD0xOTI7cT0..."
},
"..."
]
}
}
Related and Trending Searches
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=bitcoin
- 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_news",
"q": "bitcoin"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_Z4akSwQmUKCNSgInJQnBYVI4",
"status": "Success",
"created_at": "2026-11-12T14:39:45Z",
"request_time_taken": 2.03,
"parsing_time_taken": 0.0,
"total_time_taken": 2.03,
"request_url": "https://news.search.yahoo.com/news/search?p=bitcoin&vm=r",
"html_url": "https://www.searchapi.io/api/v1/searches/search_Z4akSwQmUKCNSgInJQnBYVI4.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Z4akSwQmUKCNSgInJQnBYVI4"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "bitcoin",
"yahoo_domain": "search.yahoo.com",
"safe": "on"
},
"search_information": {
"query_displayed": "bitcoin",
"total_results": 1582
},
"related_searches": [
{
"query": "bitcoin price",
"link": "https://news.search.yahoo.com/news/search;_ylt=A2RRr9ayz_VqfQIAWqjQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9..."
},
"..."
],
"trending_searches": [
{
"title": "Jensen Huang",
"snippet": "Nvidia CEO Jensen Huang and Kimberly Powell's affair rumours spark meme frenzy",
"link": "https://search.yahoo.com/search;_ylt=A2RRr9ayz_VqfQIAZ6jQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9zAzEEdnRpZ...",
"thumbnail": "https://s.yimg.com/fz/api/res/1.2/Zj_HFgEOBw5zjBBkx45AAg--~C/YXBwaWQ9c3JjaGRkO2ZpPXN0cmltO2g9MTYwO3E..."
},
"..."
]
}
Related searches and trending searches appear on search.yahoo.com. Pass a related search
query back as q to follow it.
Pagination
https://www.searchapi.io/api/v1/search?engine=yahoo_news&page=2&q=climate+change
- 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_news",
"q": "climate change",
"page": 2
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_V9Z6zEUDa6aYWVtrBWp6enSG",
"status": "Success",
"created_at": "2026-11-12T14:39:47Z",
"request_time_taken": 1.43,
"parsing_time_taken": 0.0,
"total_time_taken": 1.43,
"request_url": "https://news.search.yahoo.com/news/search?p=climate+change&vm=r&b=11",
"html_url": "https://www.searchapi.io/api/v1/searches/search_V9Z6zEUDa6aYWVtrBWp6enSG.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_V9Z6zEUDa6aYWVtrBWp6enSG"
},
"search_parameters": {
"engine": "yahoo_news",
"q": "climate change",
"yahoo_domain": "search.yahoo.com",
"safe": "on",
"page": 2
},
"search_information": {
"query_displayed": "climate change",
"total_results": 1262
},
"pagination": {
"current": 2,
"previous": "https://news.search.yahoo.com/news/search;_ylt=A2RRGQS0z_VqvAIAyurQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"next": "https://news.search.yahoo.com/news/search;_ylt=A2RRGQS0z_VqvAIAz.rQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"other_pages": {
"1": "https://news.search.yahoo.com/news/search;_ylt=A2RRGQS0z_VqvAIAy.rQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"3": "https://news.search.yahoo.com/news/search;_ylt=A2RRGQS0z_VqvAIAzOrQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"4": "https://news.search.yahoo.com/news/search;_ylt=A2RRGQS0z_VqvAIAzerQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9...",
"5": "https://news.search.yahoo.com/news/search;_ylt=A2RRGQS0z_VqvAIAzurQtDMD;_ylu=Y29sbwN1cy1lYXN0LTEEcG9..."
}
}
}
Request any page from 1 to 100 with the page parameter. A page past the last
one returns HTTP 200 with error: "Yahoo News has no more results for the requested page."