Yahoo News API Documentation

GET   /api/v1/search?engine=yahoo_news

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 example site:reuters.com tesla.

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 regional news edition, in its own language, so results differ between domains. Check the full list of supported Yahoo News yahoo_domain domains.

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_day
    • last_week
    • last_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:

    • on Default
    • moderate
    • off

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 is 100. 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_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_news&q=openai
Request
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)
Response
{
  "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

Time Period and Sort
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=nvidia&sort_by=most_recent&time_period=last_day
Request
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)
Response
{
  "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

Regional Edition
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=futebol&yahoo_domain=br.search.yahoo.com
Request
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)
Response
{
  "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

Ads
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=premier+league&yahoo_domain=uk.search.yahoo.com
Request
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)
Response
{
  "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

Knowledge Graph
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=veterans+day
Request
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)
Response
{
  "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
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_news&q=bitcoin
Request
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)
Response
{
  "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

Pagination
GET
https://www.searchapi.io/api/v1/search?engine=yahoo_news&page=2&q=climate+change
Request
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)
Response
{
  "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."