Metadata-Version: 2.4
Name: google-finance-scraper
Version: 1.0.0
Summary: Fast Google Finance scraper for stocks, forex, crypto with pandas output
Home-page: https://github.com/93627829939e93u3/google_finance_scraper.git
Author: Ganesh Raut
Author-email: Ganesh Raut <rautganesh9370@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/93627829939e93u3
Project-URL: Repository, https://github.com/93627829939e93u3/google_finance_scraper.git
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp
Requires-Dist: beautifulsoup4
Requires-Dist: pandas
Dynamic: license-file

# 📈 Google Finance Scraper

A fast, lightweight, and educational Python package to fetch **stock market data and news**
from **Google Finance**, returning clean and ready-to-use **pandas DataFrames**.

This project is built mainly for **learning, analysis, and educational purposes**, while also being
useful for dashboards, research, and personal market tools.

---

## ✨ Key Features

- 📊 Fetch **live stock data** (price, change, high/low, volume, etc.)
- 📰 Fetch **latest stock-related news**
- 🌍 Supports **Indian, US, Forex, and Crypto markets**
- 🔁 Separate functions for **stock data** and **news**
- ⚡ Async-based for better performance
- 🧠 Clean **pandas DataFrame** output
- 🧪 Ideal for students, beginners, and developers learning market data analysis

---

## 🚀 Installation

Install the package directly using pip:

```bash
pip install google-finance-scraper
```
---
## 🧠 Symbol Format (Very Important)

Google Finance uses the following symbol format:
```bash
SYMBOL:EXCHANGE    // TCS:NSE , AAPL:NASDAQ
```

## 📊 Fetch Stock Data 

### ✅ Syntax
```bash
import asyncio
from google_finance_scraper import get_stock_data

stock_df = asyncio.run(get_stock_data("SYMBOL:EXCHANGE"))
print(stock_df)

```

## 📰 Fetch Stock News
### ✅ Syntax
```bash
import asyncio
from google_finance_scraper import get_stock_news

news_df = asyncio.run(get_stock_news("SYMBOL:EXCHANGE"))
print(news_df)
```

