<p align="center">
<a href="#"><img src="docs/docs/img/full.png"></a>
</p>
<p align="center">
<em>Python wrapper for an unofficial Yahoo Finance API</em>
</p>
<p align="center">
<a href="https://travis-ci.com/dpguthrie/yahooquery" target="_blank">
<img src="https://travis-ci.com/dpguthrie/yahooquery.svg?branch=master" alt="Build Status">
</a>
<a href="https://codecov.io/gh/dpguthrie/yahooquery" target="_blank">
<img src="https://img.shields.io/codecov/c/github/dpguthrie/yahooquery" alt="Coverage">
</a>
<a href="https://pypi.org/project/yahooquery" target="_blank">
<img src="https://badge.fury.io/py/yahooquery.svg" alt="Package version">
</a>
<a href="https://pepy.tech/project/yahooquery" target="_blank">
<img src="https://pepy.tech/badge/yahooquery" alt="Downloads">
</a>
</p>
---
**Documentation**: <a target="_blank" href="https://yahooquery.dpguthrie.com">https://yahooquery.dpguthrie.com</a>
**Interactive Demo**: <a target="_blank" href="https://yahooquery.streamlit.app/">https://yahooquery.streamlit.app/</a>
**Source Code**: <a target="_blank" href="https://github.com/dpguthrie/yahooquery">https://github.com/dpguthrie/yahooquery</a>
**Blog Post**: <a target="_blank" href="https://towardsdatascience.com/the-unofficial-yahoo-finance-api-32dcf5d53df">https://towardsdatascience.com/the-unofficial-yahoo-finance-api-32dcf5d53df</a>
---
## Overview
Yahooquery is a python interface to unofficial Yahoo Finance API endpoints. The package allows a user to retrieve nearly all the data visible via the Yahoo Finance front-end.
Some features of yahooquery:
- **Fast**: Data is retrieved through API endpoints instead of web scraping. Additionally, asynchronous requests can be utilized with simple configuration
- **Simple**: Data for multiple symbols can be retrieved with simple one-liners
- **User-friendly**: Pandas Dataframes are utilized where appropriate
- **Premium**: Yahoo Finance premium subscribers are able to retrieve data available through their subscription
## Requirements
Python 2.7, 3.5+
- [Pandas](https://pandas.pydata.org) - Fast, powerful, flexible and easy to use open source data analysis and manipulation tool
- [Requests](https://requests.readthedocs.io/en/master/) - The elegant and simple HTTP library for Python, built for human beings.
- [Requests-Futures](https://github.com/ross/requests-futures) - Asynchronous Python HTTP Requests for Humans
### Yahoo Finance Premium Subscribers
- [Selenium](https://www.selenium.dev/selenium/docs/api/py/) - Web browser automation
Selenium is only utilized to login to Yahoo, which is done when the user passes certain keyword arguments. Logging into Yahoo enables users who are subscribers to Yahoo Finance Premium to retrieve data only accessible to premium subscribers.
## Installation
If you're a Yahoo Finance premium subscriber and would like to retrieve data available through your subscription, do the following:
```bash
pip install yahooquery[premium]
```
Otherwise, omit the premium argument:
```bash
pip install yahooquery
```
## Example
The majority of the data available through the unofficial Yahoo Finance API is related to a company, which is represented in yahooquery as a `Ticker`. You can instantiate the `Ticker` class by passing the company's ticker symbol. For instance, to get data for Apple, Inc., pass `aapl` as the first argument to the `Ticker` class:
```python
from yahooquery import Ticker
aapl = Ticker('aapl')
aapl.summary_detail
```
## Multiple Symbol Example
The `Ticker` class also makes it easy to retrieve data for a list of symbols with the same API. Simply pass a list of symbols as the argument to the `Ticker` class.
```python
from yahooquery import Ticker
symbols = ['fb', 'aapl', 'amzn', 'nflx', 'goog']
faang = Ticker(symbols)
faang.summary_detail
```
## License
This project is licensed under the terms of the MIT license.
Raw data
{
"_id": null,
"home_page": "",
"name": "yahooquery",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8.1,<4.0",
"maintainer_email": "",
"keywords": "python,API,finance,stocks,Yahoo Finance",
"author": "Doug Guthrie",
"author_email": "douglas.p.guthrie@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/d5/75/7e2588220c4b7d643485f9101f7da962e84bd68e970141e175d8fc3cb865/yahooquery-2.3.7.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"#\"><img src=\"docs/docs/img/full.png\"></a>\n</p>\n<p align=\"center\">\n <em>Python wrapper for an unofficial Yahoo Finance API</em>\n</p>\n<p align=\"center\">\n <a href=\"https://travis-ci.com/dpguthrie/yahooquery\" target=\"_blank\">\n <img src=\"https://travis-ci.com/dpguthrie/yahooquery.svg?branch=master\" alt=\"Build Status\">\n </a>\n <a href=\"https://codecov.io/gh/dpguthrie/yahooquery\" target=\"_blank\">\n <img src=\"https://img.shields.io/codecov/c/github/dpguthrie/yahooquery\" alt=\"Coverage\">\n </a>\n <a href=\"https://pypi.org/project/yahooquery\" target=\"_blank\">\n <img src=\"https://badge.fury.io/py/yahooquery.svg\" alt=\"Package version\">\n </a>\n <a href=\"https://pepy.tech/project/yahooquery\" target=\"_blank\">\n <img src=\"https://pepy.tech/badge/yahooquery\" alt=\"Downloads\">\n </a>\n</p>\n\n---\n\n**Documentation**: <a target=\"_blank\" href=\"https://yahooquery.dpguthrie.com\">https://yahooquery.dpguthrie.com</a>\n\n**Interactive Demo**: <a target=\"_blank\" href=\"https://yahooquery.streamlit.app/\">https://yahooquery.streamlit.app/</a>\n\n**Source Code**: <a target=\"_blank\" href=\"https://github.com/dpguthrie/yahooquery\">https://github.com/dpguthrie/yahooquery</a>\n\n**Blog Post**: <a target=\"_blank\" href=\"https://towardsdatascience.com/the-unofficial-yahoo-finance-api-32dcf5d53df\">https://towardsdatascience.com/the-unofficial-yahoo-finance-api-32dcf5d53df</a>\n\n---\n\n## Overview\n\nYahooquery is a python interface to unofficial Yahoo Finance API endpoints. The package allows a user to retrieve nearly all the data visible via the Yahoo Finance front-end.\n\nSome features of yahooquery:\n\n- **Fast**: Data is retrieved through API endpoints instead of web scraping. Additionally, asynchronous requests can be utilized with simple configuration\n- **Simple**: Data for multiple symbols can be retrieved with simple one-liners\n- **User-friendly**: Pandas Dataframes are utilized where appropriate\n- **Premium**: Yahoo Finance premium subscribers are able to retrieve data available through their subscription\n\n## Requirements\n\nPython 2.7, 3.5+\n\n- [Pandas](https://pandas.pydata.org) - Fast, powerful, flexible and easy to use open source data analysis and manipulation tool\n- [Requests](https://requests.readthedocs.io/en/master/) - The elegant and simple HTTP library for Python, built for human beings.\n- [Requests-Futures](https://github.com/ross/requests-futures) - Asynchronous Python HTTP Requests for Humans\n\n### Yahoo Finance Premium Subscribers\n\n- [Selenium](https://www.selenium.dev/selenium/docs/api/py/) - Web browser automation\n\n Selenium is only utilized to login to Yahoo, which is done when the user passes certain keyword arguments. Logging into Yahoo enables users who are subscribers to Yahoo Finance Premium to retrieve data only accessible to premium subscribers.\n\n## Installation\n\nIf you're a Yahoo Finance premium subscriber and would like to retrieve data available through your subscription, do the following:\n\n```bash\npip install yahooquery[premium]\n```\n\nOtherwise, omit the premium argument:\n\n```bash\npip install yahooquery\n```\n\n## Example\n\nThe majority of the data available through the unofficial Yahoo Finance API is related to a company, which is represented in yahooquery as a `Ticker`. You can instantiate the `Ticker` class by passing the company's ticker symbol. For instance, to get data for Apple, Inc., pass `aapl` as the first argument to the `Ticker` class:\n\n```python\nfrom yahooquery import Ticker\n\naapl = Ticker('aapl')\n\naapl.summary_detail\n```\n\n## Multiple Symbol Example\n\nThe `Ticker` class also makes it easy to retrieve data for a list of symbols with the same API. Simply pass a list of symbols as the argument to the `Ticker` class.\n\n```python\nfrom yahooquery import Ticker\n\nsymbols = ['fb', 'aapl', 'amzn', 'nflx', 'goog']\n\nfaang = Ticker(symbols)\n\nfaang.summary_detail\n```\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python wrapper for an unofficial Yahoo Finance API",
"version": "2.3.7",
"project_urls": {
"Documentation": "https://yahooquery.dpguthrie.com"
},
"split_keywords": [
"python",
"api",
"finance",
"stocks",
"yahoo finance"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d1a99a06f31cc068c7997b63a358f94ed433afb28599ef63bdcd5333db4a19d8",
"md5": "7f3d035870ffd79cb7ebb16313fd883c",
"sha256": "6b3808e515b3fa5e32cf7b72f9a13991cde7b212830879ed00851aad0b8f529e"
},
"downloads": -1,
"filename": "yahooquery-2.3.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7f3d035870ffd79cb7ebb16313fd883c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8.1,<4.0",
"size": 52749,
"upload_time": "2023-12-16T18:44:33",
"upload_time_iso_8601": "2023-12-16T18:44:33.087193Z",
"url": "https://files.pythonhosted.org/packages/d1/a9/9a06f31cc068c7997b63a358f94ed433afb28599ef63bdcd5333db4a19d8/yahooquery-2.3.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d5757e2588220c4b7d643485f9101f7da962e84bd68e970141e175d8fc3cb865",
"md5": "4ab9005c2d018c5643fd012ece35eb72",
"sha256": "edb0db22316be7b0f4cdb051c3dfacaeaafef810ace92622cf8254cf5bb81b06"
},
"downloads": -1,
"filename": "yahooquery-2.3.7.tar.gz",
"has_sig": false,
"md5_digest": "4ab9005c2d018c5643fd012ece35eb72",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8.1,<4.0",
"size": 50164,
"upload_time": "2023-12-16T18:44:35",
"upload_time_iso_8601": "2023-12-16T18:44:35.062067Z",
"url": "https://files.pythonhosted.org/packages/d5/75/7e2588220c4b7d643485f9101f7da962e84bd68e970141e175d8fc3cb865/yahooquery-2.3.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-16 18:44:35",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "yahooquery"
}
JSON