Skip to main content
Ctrl+K
yfinance - Home
  • Advanced
  • API Reference
  • Development
  • GitHub
  • Advanced
  • API Reference
  • Development
  • GitHub

Section Navigation

  • Ticker and Tickers
    • Ticker
    • Tickers
  • Stock
    • yfinance.Ticker.get_isin
    • yfinance.Ticker.isin
    • yfinance.Ticker.history
    • yfinance.Ticker.get_history_metadata
    • yfinance.Ticker.get_dividends
    • yfinance.Ticker.dividends
    • yfinance.Ticker.get_splits
    • yfinance.Ticker.splits
    • yfinance.Ticker.get_actions
    • yfinance.Ticker.actions
    • yfinance.Ticker.get_capital_gains
    • yfinance.Ticker.capital_gains
    • yfinance.Ticker.get_shares_full
    • yfinance.Ticker.get_info
    • yfinance.Ticker.info
    • yfinance.Ticker.get_fast_info
    • yfinance.Ticker.fast_info
    • yfinance.Ticker.get_news
    • yfinance.Ticker.news
  • Market
    • Market
  • Financials
    • yfinance.Ticker.get_income_stmt
    • yfinance.Ticker.income_stmt
    • yfinance.Ticker.quarterly_income_stmt
    • yfinance.Ticker.ttm_income_stmt
    • yfinance.Ticker.get_balance_sheet
    • yfinance.Ticker.balance_sheet
    • yfinance.Ticker.get_cashflow
    • yfinance.Ticker.cashflow
    • yfinance.Ticker.quarterly_cashflow
    • yfinance.Ticker.ttm_cashflow
    • yfinance.Ticker.get_earnings
    • yfinance.Ticker.earnings
    • yfinance.Ticker.calendar
    • yfinance.Ticker.get_earnings_dates
    • yfinance.Ticker.earnings_dates
    • yfinance.Ticker.get_sec_filings
    • yfinance.Ticker.sec_filings
  • Analysis & Holdings
    • yfinance.Ticker.get_recommendations
    • yfinance.Ticker.recommendations
    • yfinance.Ticker.get_recommendations_summary
    • yfinance.Ticker.recommendations_summary
    • yfinance.Ticker.get_upgrades_downgrades
    • yfinance.Ticker.upgrades_downgrades
    • yfinance.Ticker.get_sustainability
    • yfinance.Ticker.sustainability
    • yfinance.Ticker.get_analyst_price_targets
    • yfinance.Ticker.analyst_price_targets
    • yfinance.Ticker.get_earnings_estimate
    • yfinance.Ticker.earnings_estimate
    • yfinance.Ticker.get_revenue_estimate
    • yfinance.Ticker.revenue_estimate
    • yfinance.Ticker.get_earnings_history
    • yfinance.Ticker.earnings_history
    • yfinance.Ticker.get_eps_trend
    • yfinance.Ticker.eps_trend
    • yfinance.Ticker.get_eps_revisions
    • yfinance.Ticker.eps_revisions
    • yfinance.Ticker.get_growth_estimates
    • yfinance.Ticker.growth_estimates
    • yfinance.Ticker.get_funds_data
    • yfinance.Ticker.funds_data
    • yfinance.Ticker.get_insider_purchases
    • yfinance.Ticker.insider_purchases
    • yfinance.Ticker.get_insider_transactions
    • yfinance.Ticker.insider_transactions
    • yfinance.Ticker.get_insider_roster_holders
    • yfinance.Ticker.insider_roster_holders
    • yfinance.Ticker.get_major_holders
    • yfinance.Ticker.major_holders
    • yfinance.Ticker.get_institutional_holders
    • yfinance.Ticker.institutional_holders
    • yfinance.Ticker.get_mutualfund_holders
    • yfinance.Ticker.mutualfund_holders
  • Market
    • Market
  • Search & Lookup
    • Search
    • Lookup
  • WebSocket
    • WebSocket
    • AsyncWebSocket
  • Sector and Industry
    • Sector
    • Industry
  • Screener & Query
    • EquityQuery
    • FundQuery
    • yfinance.screen
  • Functions and Utilities
    • yfinance.download
    • yfinance.enable_debug_mode
    • yfinance.set_tz_cache_location
  • FundsData class
    • FundsData
  • PriceHistory class
  • API Reference
  • Search & Lookup
  • Search

Search#

class yfinance.Search(query, max_results=8, news_count=8, lists_count=8, include_cb=True, include_nav_links=False, include_research=False, include_cultural_assets=False, enable_fuzzy_query=False, recommended=8, session=None, proxy=<object object>, timeout=30, raise_errors=True)#

Fetches and organizes search results from Yahoo Finance, including stock quotes and news articles.

Parameters:
  • query – The search query (ticker symbol or company name).

  • max_results – Maximum number of stock quotes to return (default 8).

  • news_count – Number of news articles to include (default 8).

  • lists_count – Number of lists to include (default 8).

  • include_cb – Include the company breakdown (default True).

  • include_nav_links – Include the navigation links (default False).

  • include_research – Include the research reports (default False).

  • include_cultural_assets – Include the cultural assets (default False).

  • enable_fuzzy_query – Enable fuzzy search for typos (default False).

  • recommended – Recommended number of results to return (default 8).

  • session – Custom HTTP session for requests (default None).

  • timeout – Request timeout in seconds (default 30).

  • raise_errors – Raise exceptions on error (default True).

Attributes

all

filtered down version of response.

Type:

Get all the results from the search results

lists

Get the lists from the search results.

nav

Get the navigation links from the search results.

news

Get the news from the search results.

quotes

Get the quotes from the search results.

research

Get the research reports from the search results.

response

Get the raw response from the search results.

Methods

__init__(query, max_results=8, news_count=8, lists_count=8, include_cb=True, include_nav_links=False, include_research=False, include_cultural_assets=False, enable_fuzzy_query=False, recommended=8, session=None, proxy=<object object>, timeout=30, raise_errors=True)

Fetches and organizes search results from Yahoo Finance, including stock quotes and news articles.

Parameters:
  • query – The search query (ticker symbol or company name).

  • max_results – Maximum number of stock quotes to return (default 8).

  • news_count – Number of news articles to include (default 8).

  • lists_count – Number of lists to include (default 8).

  • include_cb – Include the company breakdown (default True).

  • include_nav_links – Include the navigation links (default False).

  • include_research – Include the research reports (default False).

  • include_cultural_assets – Include the cultural assets (default False).

  • enable_fuzzy_query – Enable fuzzy search for typos (default False).

  • recommended – Recommended number of results to return (default 8).

  • session – Custom HTTP session for requests (default None).

  • timeout – Request timeout in seconds (default 30).

  • raise_errors – Raise exceptions on error (default True).

search() → Search

Search using the query parameters defined in the constructor.

property all: dict[str, list]#

filtered down version of response.

Type:

Get all the results from the search results

property lists: list#

Get the lists from the search results.

property nav: list#

Get the navigation links from the search results.

property news: list#

Get the news from the search results.

property quotes: list#

Get the quotes from the search results.

property research: list#

Get the research reports from the search results.

property response: dict#

Get the raw response from the search results.

search() → Search#

Search using the query parameters defined in the constructor.

previous

Search & Lookup

next

Lookup

On this page
  • Search
    • Search.all
    • Search.lists
    • Search.nav
    • Search.news
    • Search.quotes
    • Search.research
    • Search.response
    • Search.search()
Show Source

© Copyright 2017-2025 Ran Aroussi.

Created using Sphinx 8.0.2.

Built with the PyData Sphinx Theme 0.15.4.