# Google Finance Scraper & Stock Market Data API (`dev00/google-finance-scraper-api`) Actor

Extract real-time Google Finance stock quotes, historical OHLC charts, company financials, earnings transcripts, AI research, and congressional trades.

- **URL**: https://apify.com/dev00/google-finance-scraper-api.md
- **Developed by:** [dev00](https://apify.com/dev00) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 1,000 financial query / live quotes

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## 📈 Google Finance Scraper - Live Quotes, OHLC Charts, Financials, Transcripts & AI Research

> 🚀 **The #1 Most Complete, Low-Latency Real-Time Google Finance Market Intelligence, Financial Statements, Earnings Call Transcripts & US Congressional Stock Trading Scraper on Apify.**

Looking for reliable, low-latency live stock prices, cryptocurrency data, currency exchange rates, historical candle charts with SVG sparklines, corporate financial statements, and full earnings call transcripts without maintaining costly terminal subscriptions?

The **Google Finance Scraper** delivers real-time asset quotes, interactive time-series price data across multiple timeframes (`1D`, `5D`, `1M`, `6M`, `YTD`, `1Y`, `5Y`, `MAX`), complete income statements, balance sheets, cash flow reports, upcoming earnings announcements, word-for-word earnings call transcripts, Gemini 3.1 High AI financial catalyst research, and US Congressional insider trading disclosures directly from Google Finance.

***

### 🌟 Why This Actor Outperforms Competitors

| Capability | Alpha Vantage / Yahoo | Bloomberg / FactSet | 📈 Google Finance Scraper |
| :--- | :---: | :---: | :---: |
| **Real-Time Live Quotes** | ⚠️ 15-min Delayed (Free Tier) | 💸 $2,000+/month | ✅ **Live Real-Time Quotes (~150ms)** |
| **Interactive OHLC Charts** | ⚠️ Basic JSON | ⚠️ Complex Format | ✅ **OHLC Time-Series + SVG Sparklines** |
| **US Congressional Trades** | ❌ No | ⚠️ Add-on Required | ✅ **House & Senate Politician Stock Tracker** |
| **Full Earnings Transcripts** | ❌ No | 💸 Expensive Add-on | ✅ **Executive Speeches, Timeline & Q\&A** |
| **AI Catalyst & Deep Dive** | ❌ No | ❌ No | ✅ **Gemini 3.1 High Financial AI Research** |
| **Complete Financial Statements** | ⚠️ Limited Historical | ⚠️ Clunky APIs | ✅ **Quarterly & Annual Income, Balance, Cash** |
| **Multi-Asset Class Coverage** | ⚠️ Stocks Only | ⚠️ Fragmented | ✅ **Equities, Crypto, Forex, Indexes, Energy** |
| **Pricing Model** | 💸 High Monthly Subscriptions | 💸 Custom Enterprise Contracts | ⚡ **Pay-Per-Event ($0.003 / finance query)** |

***

### ⚡ Comprehensive Feature Breakdown

#### 1. 📊 Real-Time Asset Quotes (`QUOTE`)

Extract real-time price, day high/low, 52-week range, market cap, P/E ratio, dividend yield, beta, trading volume, primary exchange, and after-hours trading for any stock, ETF, crypto, index, forex pair, or commodity.

- **Equities**: Apple (`AAPL`), NVIDIA (`NVDA`), Tesla (`TSLA`), Microsoft (`MSFT`), Amazon (`AMZN`), Alphabet (`GOOGL`), Li Auto (`LI`), Frontline (`FRO`), Alembic Pharma (`APLLTD:NSE`).
- **Cryptocurrencies**: Bitcoin (`BTC-USD`), Ethereum (`ETH-USD`), Solana (`SOL-USD`), XRP, Cardano.
- **Broad Market Indexes**: S\&P 500 (`.INX`), Dow Jones (`.DJI`), Nasdaq Composite (`.IXIC`), FTSE 100 (`UKX`), Nikkei 225 (`NI225`).
- **Commodities & Energy**: Gold (`GCW00`), Crude Oil WTI (`CLW00`), Silver (`SIW00`), Natural Gas.
- **Forex Currencies**: EUR/USD (`EUR-USD`), GBP/USD (`GBP-USD`), USD/JPY, USD/CAD, USD/MAD.

#### 2. 🤖 AI Financial Research & Catalysts (`AI_RESEARCH`)

Leverage Gemini 3.1 High models to generate detailed bullish investment catalysts, bearish risk factors, margin expansion analysis, and fundamental answers for any company or ticker.

- Automated fundamental catalyst extraction.
- Bullish expansion drivers and competitive moat evaluation.
- Bearish macro headwinds, valuation risks, and supply chain friction.
- Wall Street consensus analyst ratings and price targets (Low, Mean, High).

#### 3. 📈 Historical OHLC Candle Data & Sparklines (`CHART`)

Generate structured time-series data points across custom windows (`1D`, `5D`, `1M`, `6M`, `YTD`, `1Y`, `5Y`, `MAX`) with embeddable SVG sparklines.

- Open, High, Low, Close (OHLC) pricing.
- Volume distribution per candle.
- Period high, period low, absolute price change, and percentage return.
- Lightweight, responsive vector SVG sparkline for direct HTML embedding.

#### 4. 🏛️ US Congressional & Insider Trading Tracker (`CONGRESS_TRADING`)

Track stock purchases and sales made by US Senators and Representatives with trade amounts, disclosure filing dates, and official disclosure links.

- Member of Congress (Senator / Representative), Political Party, Chamber & District.
- Owner type (Self, Spouse, Dependent Child).
- Transaction Type (Purchase / Sale / Option Exercise).
- Transaction Amount Range (`$1,001 - $15,000`, `$15,001 - $50,000`, `$1,000,001 - $5,000,000`).
- Direct link to official House and Senate financial disclosure filings.

#### 5. 🎙️ Full Earnings Call Transcripts (`EARNINGS_TRANSCRIPT`)

Access word-for-word earnings conference call transcripts categorized by speaker (Operator, CEO, CFO, Investment Analysts) with timestamps and Q\&A.

- Participant directory with executive titles and Wall Street analyst firms.
- Chronological timestamped speech sections.
- Management opening remarks and financial review.
- Live analyst Q\&A session transcripts.

#### 6. 📑 Complete Financial Statements (`FINANCIALS`)

Query standardized Income Statements, Balance Sheets, and Cash Flow Statements on a quarterly or annual basis.

- **Income Statement**: Revenue, Cost of Revenue, Gross Profit, Operating Expenses, Operating Income, Net Income, EBITDA, EPS (Basic & Diluted), Effective Tax Rate.
- **Balance Sheet**: Cash & Short-Term Investments, Total Current Assets, Total Assets, Total Liabilities, Long-Term Debt, Total Equity, Book Value Per Share.
- **Cash Flow Statement**: Cash from Operations, Cash from Investing, Cash from Financing, Capital Expenditures (CapEx), Free Cash Flow.

#### 7. 🌍 Market Trends, Movers & Indexes (`MARKET_TRENDS`)

Instant access to Top Gainers, Top Losers, Most Active stocks, and global market indexes.

- Real-time ranking of biggest percentage gainers and decliners.
- High-volume market movers and retail trading favorites.
- Global equity benchmark performance.

#### 8. 📰 Financial News Stories & Headlines (`NEWS`)

Real-time financial headlines curated by ticker or market-wide with sentiment analysis, publisher attribution, and thumbnail images.

***

### 📥 Input Examples

#### Example 1: Real-Time Live Quote

```json
{
  "mode": "QUOTE",
  "symbol": "AAPL"
}
```

#### Example 2: AI Financial Research & Catalyst Analysis

```json
{
  "mode": "AI_RESEARCH",
  "symbol": "NVDA",
  "aiPrompt": "Analyze key bullish catalysts, margin expansion and risk factors for Nvidia"
}
```

#### Example 3: US Congressional Stock Trading Tracker

```json
{
  "mode": "CONGRESS_TRADING",
  "symbol": "NVDA",
  "limit": 10
}
```

#### Example 4: Historical 1-Month OHLC Price Chart

```json
{
  "mode": "CHART",
  "symbol": "TSLA",
  "timeframe": "1M"
}
```

#### Example 5: Full Earnings Conference Call Transcript

```json
{
  "mode": "EARNINGS_TRANSCRIPT",
  "symbol": "LI",
  "quarter": "Q2",
  "year": 2026
}
```

***

### 📤 Output Sample (Live Quote)

```json
{
  "mode": "LIVE_QUOTE",
  "symbol": "AAPL",
  "exchange": "NASDAQ",
  "full_ticker": "AAPL:NASDAQ",
  "name": "Apple Inc.",
  "asset_type": "STOCK",
  "currency": "USD",
  "price": 228.85,
  "price_formatted": "$228.85",
  "change": 1.70,
  "change_percentage": 0.75,
  "change_percentage_formatted": "+0.75%",
  "trading_day": {
    "open": 227.60,
    "high": 229.45,
    "low": 226.90,
    "previous_close": 227.15,
    "volume": 48293100
  },
  "valuation": {
    "market_cap": 3485000000000,
    "market_cap_formatted": "$3.49T",
    "pe_ratio": 34.82,
    "dividend_yield_formatted": "0.44%",
    "fifty_two_week_high": 237.23,
    "fifty_two_week_low": 164.08,
    "beta": 1.24
  },
  "after_hours": {
    "price": 229.10,
    "change": 0.25,
    "change_percentage": 0.11,
    "session": "AFTER_HOURS"
  },
  "google_finance_url": "https://www.google.com/finance/quote/AAPL:NASDAQ?hl=en-US"
}
```

***

### 💡 Practical Use Cases

1. **Algorithmic Trading & Quantitative Research**: Feed real-time quotes, technical OHLC historical series, and market momentum metrics into custom trading bots.
2. **Financial Newsletters & Market Portals**: Automate daily market summaries with top gainers, losers, economic indexes, and embeddable SVG sparkline charts.
3. **Institutional Equity Research**: Extract full earnings transcripts, quarterly balance sheets, and cash flow statements for financial modeling in Excel or Google Sheets.
4. **Congressional Trading Watchers**: Build automated alerts and social bots tracking US politicians trading individual stocks ahead of major legislative decisions.
5. **AI Financial Agents & Portfolio Advisors**: Integrate Gemini 3.1 High financial research into LLM agent workflows, answering investor questions with structured fundamental data.

***

### 🏷️ Keywords & SEO Tags

`google finance api`, `google finance scraper`, `real-time stock market data`, `live stock quotes api`, `historical ohlc stock chart`, `stock sparkline svg`, `company financials api`, `balance sheet scraper`, `income statement api`, `cash flow statement scraper`, `earnings calendar api`, `earnings call transcripts`, `executive speech transcript`, `congressional stock trading tracker`, `insider trading api`, `us politician stock tracker`, `pelosi stock tracker`, `gemini financial ai`, `stock catalyst analysis`, `top gainers scraper`, `market movers api`, `cryptocurrency prices api`, `forex currency rates`, `gold price api`, `crude oil futures`, `alpha vantage alternative`, `yahoo finance api alternative`, `bloomberg terminal alternative`, `apify finance scraper`, `financial market intelligence`

# Actor input Schema

## `mode` (type: `string`):

Select the financial intelligence module to execute.

## `symbol` (type: `string`):

Stock ticker, crypto pair, index or commodity (e.g. AAPL, NVDA, TSLA, LI, FRO, BTC-USD, .INX, EUR-USD, GCW00).

## `aiPrompt` (type: `string`):

Natural language query (e.g. 'Analyze key bullish drivers and margin expansion for Nvidia', 'What are Apple's growth catalysts?').

## `timeframe` (type: `string`):

Time window for historical candle chart generation.

## `period` (type: `string`):

Quarterly or annual reporting period.

## `quarter` (type: `string`):

Fiscal quarter for conference call transcript (e.g. Q1, Q2, Q3, Q4).

## `year` (type: `integer`):

Fiscal year for conference call transcript (e.g. 2026).

## `category` (type: `string`):

Filter market trends and mover rankings.

## `limit` (type: `integer`):

Maximum number of records to return (1–50).

## Actor input object example

```json
{
  "mode": "QUOTE",
  "symbol": "AAPL",
  "aiPrompt": "Analyze key bullish catalysts, margin expansion and risk factors",
  "timeframe": "1M",
  "period": "quarterly",
  "quarter": "Q2",
  "year": 2026,
  "category": "all",
  "limit": 15
}
```

# Actor output Schema

## `results` (type: `string`):

Direct link to the dataset items containing extracted financial records

## `keyValueStoreResult` (type: `string`):

Direct link to the key-value store output record

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "symbol": "AAPL",
    "aiPrompt": "Analyze key bullish catalysts, margin expansion and risk factors",
    "quarter": "Q2",
    "year": 2026
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/google-finance-scraper-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "symbol": "AAPL",
    "aiPrompt": "Analyze key bullish catalysts, margin expansion and risk factors",
    "quarter": "Q2",
    "year": 2026,
}

# Run the Actor and wait for it to finish
run = client.actor("dev00/google-finance-scraper-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "symbol": "AAPL",
  "aiPrompt": "Analyze key bullish catalysts, margin expansion and risk factors",
  "quarter": "Q2",
  "year": 2026
}' |
apify call dev00/google-finance-scraper-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dev00/google-finance-scraper-api"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/zTsuSSNJj85ygpNHK/builds/GABxJRK6xbUqIDFVR/openapi.json
