Getting Started

Installation

yahooquery is published on PyPI and installs with pip, uv, or any PEP 517–compatible installer. Versions 2.4.0 and later require Python 3.9 or newer.

Standard install

bashterminal
pip install yahooquery

Install with uv

If you use uv as your package manager:

bashterminal
uv pip install yahooquery

Yahoo Finance Premium subscribers

Premium data access requires Selenium for the Yahoo login flow. Install the extra:

bashterminal
pip install yahooquery[premium]
Heads up: Selenium is only used to log in to Yahoo when you pass specific keyword arguments. Everything else works without a browser. See the Premium guide.

Dependencies

Three packages do the heavy lifting:

PackageRole
pandasDataFrames for tabular responses
requestsHTTP calls to Yahoo’s endpoints
requests-futuresAsynchronous request support

Verify the install

pythonverify.py
import yahooquery

yahooquery.__version__  # '2.4.1'
Next: the Quickstart walks through your first real data pull in under five minutes.