---
id: yahooquery
version: "2.4.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# yahooquery — Python wrapper for an unofficial Yahoo Finance API

License: permissive · Maintenance: aging · Downloads: 162.6K/mo

## What it is and what it does

Yahooquery is a Python wrapper around Yahoo Finance's unofficial API endpoints, letting you fetch stock quotes, company fundamentals, and market data without web scraping. It returns data as pandas DataFrames, making it easy to work with financial datasets in analysis pipelines. The package supports both single ticker lookups and batch requests for multiple symbols, and can use asynchronous requests for faster data retrieval.

The package depends on pandas for data structures, requests-futures for async HTTP, beautifulsoup4 and lxml for parsing, and curl-cffi for HTTP requests. It targets Python 3.9+. Premium Yahoo Finance subscribers can optionally install Selenium support to authenticate and access subscription-only data, though the core package works without it.

Use it for:

- Fetch current stock quotes and historical price data for a portfolio of ticker symbols into a single DataFrame.
- Build a financial analysis script that retrieves company fundamentals (earnings, revenue, ratios) for comparison across multiple stocks.
- Populate a pandas-based backtesting system with real-time market data from Yahoo Finance without maintaining a separate data feed.
- Create a monitoring dashboard that periodically pulls updated financial metrics for a watchlist of stocks.
- Access premium Yahoo Finance data (if subscribed) programmatically for institutional or professional analysis workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Retrieves financial data from Yahoo Finance through an unofficial API, returning stock information, company details, and market data as pandas DataFrames for single or multiple ticker symbols.

Yes, if you need quick access to Yahoo Finance data and can tolerate the unofficial API's stability risks. The low install friction and pandas integration make it convenient for financial analysis scripts. However, the aging maintenance status (last release 456 days ago) means the unofficial API could break without timely fixes, so verify current reliability before depending on it in production systems.

## Install

pip install yahooquery
uv add yahooquery
poetry add yahooquery

## Installing yahooquery

Before you install: Low install friction with six runtime dependencies (beautifulsoup4, curl-cffi, lxml, pandas, requests-futures, tqdm). Maintenance status is aging—last release was 456 days ago—so expect slower response to issues or breaking API changes from Yahoo Finance.

License in practice: MIT license is permissive; you can use, modify, and distribute yahooquery with minimal restrictions, though you must retain the license notice.

Quickstart:

pip install yahooquery

from yahooquery import Ticker

aapl = Ticker('aapl')
print(aapl.summary_detail)

Requires Python 3.9 or later. Yahoo Finance API endpoints are unofficial and subject to change without notice.

Verify before relying:

- Whether the unofficial Yahoo Finance API remains stable and accessible, or if endpoint changes have broken functionality since the last release 456 days ago.
- Whether asynchronous request support mentioned in the description is fully functional and documented in current version.
- Premium subscriber features (Selenium-based login) and their current reliability with Yahoo's authentication.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 162.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

yahoo finance api wrapper, stock data retrieval python, ticker symbol financial data, market data pandas dataframe, unofficial yahoo finance, stock quotes and fundamentals, financial data scraping alternative, finance-data, stock-market, api-wrapper

[View on SkillFed](https://skillfed.io/packages/yahooquery) · [View on PyPI](https://pypi.org/project/yahooquery/)