# Google Finance Data Scraper — Stocks & Quotes (`sian.agency/google-finance-data-scraper`) Actor

Search Google Finance instruments or retrieve one stock quote. Export ranked matches, symbols, prices and available quote fields in one completed record. Supports explicit symbol checks and timestamped JSON observations.

- **URL**: https://apify.com/sian.agency/google-finance-data-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** Business, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $110.00 / 1,000 completed finance search records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Finance stock search and quote data 📈

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Yahoo Finance](https://img.shields.io/badge/Store-Yahoo%20Finance-6001D2)](https://apify.com/sian.agency/yahoo-finance-scraper?fpr=sian) [![Google News](https://img.shields.io/badge/Store-Google%20News-4285F4)](https://apify.com/sian.agency/google-news-scraper?fpr=sian) [![Google Search](https://img.shields.io/badge/Store-Google%20Search-4285F4)](https://apify.com/sian.agency/google-serp-scraper?fpr=sian)

#### 📈 Two focused operations, one complete finance record

##### Research symbols and quote observations without maintaining a browser.

### 🔎 What is the Google Finance Data Scraper — and when should you use it?

The **Google Finance Data Scraper** turns Google Finance stock searches and quotes as complete JSON records into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

**Use it when you need:** ranked instrument matches or a stock quote with available price fields.

**Use something else when:** you need Yahoo Finance market data. Use [Yahoo Finance Scraper](https://apify.com/sian.agency/yahoo-finance-scraper?fpr=sian) for Yahoo Finance data. This actor does not provide historical time series or executable trading prices.

### 🤖 Use with AI agents

Already connected to the [Apify MCP server](https://mcp.apify.com)? Just ask for this Actor by name: sian.agency/google-finance-data-scraper

**Agentic payments:** Availability of [x402](https://www.x402.org/) and [Skyfire](https://www.skyfire.xyz/) depends on this Actor's current Store eligibility. Check the published listing for supported payment methods. One completed search or quote record is charged. A valid empty search is charged once. Failed retrievals have no result charge; a separate run-start fee applies.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

```text
I want Google Finance instrument research using the Apify Actor `sian.agency/google-finance-data-scraper`.

Use it when I need: ranked instrument matches or a stock quote with available price fields.

Don't use it when: you need Yahoo Finance market data — use yahoo-finance-scraper instead.

How to call it: set operation search with query, or quote with a full symbol such as AAPL:NASDAQ.

Start with this input:
{
  "operation": "search",
  "query": "apple"
}

Ask me whether they need instrument discovery or a stock quote, and the query or symbol, then run the Actor and summarise the results as a table.
```

**Things you can ask your agent for:**

- *Find Apple instruments and list their returned symbols.*
- *Retrieve AAPL:NASDAQ and show its price and quote update time.*
- *Save a Microsoft instrument search as JSON.*

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at [apify.com/sian.agency/google-finance-data-scraper.md](https://apify.com/sian.agency/google-finance-data-scraper.md).

### 📋 Overview

Google Finance Data Scraper searches instruments or retrieves a stock quote for a full symbol. Each completed request creates one record containing the returned data. Prices can be delayed; check the quote timestamp.

- ✅ **Complete records**: All returned search groups remain in JSON.
- 🏷️ **Symbol checks**: Quote output must match the requested instrument.
- 🕒 **Available timestamps**: Preserve source quote times without inventing freshness.
- 💰 **Clear billing**: One result event per completed request, including an empty search.
- 📄 **Run report**: Review the result, charges and any retry advice.

***

### ✨ Features

- 🔎 **Instrument discovery**: Search companies or ticker phrases.
- 📈 **Stock quotes**: Retrieve price, OHLC, volume and other available values.
- 📦 **Nested JSON**: Keep every returned group and quote field.
- 🏷️ **Exact quote symbol**: Reject a response for another symbol.
- 🔍 **Empty observations**: See zero-result searches explicitly.
- 📊 **Exports**: Download JSON, CSV or Excel from Apify.
- 🗓️ **Scheduling**: Save your own repeated observations.

***

### 🎬 Quick Start

Choose search and enter a company, or choose quote and enter a symbol such as AAPL:NASDAQ. Start the actor and open the dataset. Work inputs are examples in the Console; API callers must supply them.

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~google-finance-data-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' -d '{"operation":"search","query":"apple"}'
```

### 🚀 Getting Started

#### Step 1: Choose your operation

Use search for instrument discovery or quote for a stock symbol.

#### Step 2: Supply the input

Enter a query or a Google Finance symbol including its exchange.

#### Step 3: Review and export

Open the completed record and download JSON to preserve all nested data.

***

### 📥 Input Configuration

| Field | Type | Required | Description |
|---|---|---|---|
| operation | select | No | search or quote; defaults to search |
| query | string | For search | Company or instrument search phrase |
| symbol | string | For quote | Full symbol, for example AAPL:NASDAQ |

```json
{"operation":"quote","symbol":"AAPL:NASDAQ"}
```

One request runs at a time. Bulk input, localization, historical series and portfolio calculations are outside this actor's scope.

***

### 📤 Output

| Field | Type | Description |
|---|---|---|
| query | string | Search phrase, when searching |
| symbol | string | Verified quote symbol |
| nameText | string | First match or quoted company name |
| price | number | Available first-match or quote price |
| resultCount | integer | Instruments in the record |
| symbols | array | Returned instrument symbols |
| instruments | object | Full search result groups |
| quote | object | Full quote response |
| lastUpdateUtc | string | Available source quote update time |
| empty | boolean | Whether a completed search has zero matches |
| complete | boolean | Whether retrieval completed |
| \_fetchedAt | string | Actor retrieval time |
| processedAt | string | UTC ISO observation timestamp |
| scrapingDate | string | Same UTC ISO timestamp as processedAt |
| status | string | success or error |

```json
{"status":"success","complete":true,"_operation":"quote","symbol":"AAPL:NASDAQ","nameText":"Apple Inc","price":342.96,"resultCount":1,"symbols":["AAPL:NASDAQ"],"empty":false,"lastUpdateUtc":"2026-10-15 00:30:00"}
```

The example is a recorded observation, not a current price. Search can include related companies. Currency is never inferred from the exchange when absent.

***

### 💼 Use Cases & Examples

#### 1. Financial researchers

Search for apple, then inspect the returned stock and ETF groups before choosing a symbol. Use a second quote request for AAPL:NASDAQ when the listing matters; the quote must match the symbol you supplied.

#### 2. Market analysts

Schedule a quote for MSFT:NASDAQ and keep each returned record with processedAt and the available quote update time. Compare your saved observations after checking their timestamps; the actor does not return a historical price series.

#### 3. Content editors

Check the full stock symbol named in a draft and save the returned quote alongside your source notes. Prices can be delayed, so include the available update time and verify any price before publishing it.

#### 4. Data teams

Export a company search as JSON and inspect its stock, ETF, index and other returned groups in your own pipeline. One search creates one observation record, even when it contains several instrument matches.

#### 5. Educators

Use an Apple or Microsoft search to discuss company names, exchange-qualified symbols and the difference between search discovery and a quote. Follow a selected symbol into quote mode rather than assuming the first company-name match is the intended listing.

#### 6. Automation teams

Trigger a quote lookup from an Apify schedule or a workflow when a known Google Finance symbol needs checking. Route a failed symbol check for review instead of treating an absent quote as a zero price.

***

### 🔗 Integration Examples

#### JavaScript

```javascript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('sian.agency/google-finance-data-scraper').call({ operation: 'quote', symbol: 'AAPL:NASDAQ' });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('sian.agency/google-finance-data-scraper').call(run_input={'operation': 'search', 'query': 'microsoft'})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)
```

#### cURL

```bash
curl -X POST 'https://api.apify.com/v2/acts/sian.agency~google-finance-data-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' -d '{"operation":"search","query":"apple"}'
```

#### Automation Workflows (N8N / Zapier / Make)

1. Trigger from a schedule or webhook.
2. Run the actor with a query or symbol.
3. Read the completed record and check status.
4. Save the observation or compare it with your earlier records.

***

### 📊 Performance & Pricing

One completed search or quote record is charged once. Matches inside a search add no result charges. A valid empty search is also a completed, billable observation. Failed retrievals have no result-event charge.

A separate platform run-start fee applies, including invalid or stopped runs. Paid Apify plans receive tier discounts. Free-plan users can test one record per run from the Console or MCP; direct API access requires a paying plan.

[View the live tier prices](https://apify.com/sian.agency/google-finance-data-scraper?fpr=sian) before starting. There is no claim that every query is supported or that prices are suitable for trading.

***

### ❓ Frequently Asked Questions

**Q: What is charged?**

One completed search or quote record. An empty completed search is charged. Failed retrievals have no result-event charge; a separate run-start fee applies.

**Q: Are these trading prices?**

No. Quotes may be delayed. Check the source timestamp and use a licensed market feed for execution.

**Q: Why are related companies returned?**

Search is ranked instrument discovery, not an exact keyword filter.

**Q: Can I download price history?**

This actor covers instrument search and one stock quote only.

**Q: Does an empty API input run the example?**

No. Work inputs have Console prefills and no API default.

**Q: Which exports keep full data?**

JSON preserves nested groups and quote fields. CSV and Excel encode nested values as text.

***

### 🐛 Troubleshooting

**No useful instrument match**

- Try the company name or a full symbol. Search is ranked discovery and can include related companies.

**Quote unavailable**

- Check the exchange suffix and the symbol's Google Finance page. No result-event charge applies to a failed retrieval.

**Request stopped**

- Check the maximum charge, available credits and free-run allowance before restarting.

**Data looks older than expected**

- Read lastUpdateUtc inside the quote record. Retrieval time and market update time are different.

***

### ⚖️ Is it legal to scrape data?

Use public financial information for a lawful purpose and respect applicable rights and source terms. Public availability does not itself grant a redistribution license. This actor does not provide investment advice or trading execution data.

Results may contain personal data. If you process it, establish an appropriate legal basis under GDPR or other applicable rules. Read [Apify's overview of web scraping legality](https://blog.apify.com/is-web-scraping-legal/) and obtain advice for your use case when needed.

Google and Google Finance are trademarks of Google LLC. SIÁN Agency is independent and is not affiliated with or endorsed by Google.

***

### 🤝 Support

Open an [actor issue](https://apify.com/sian.agency/google-finance-data-scraper/issues) with the run link and input. Send questions to <apify@sian-agency.online>.

**Built by [SIÁN Agency](https://www.sian-agency.online)** | **[More tools](https://apify.com/sian.agency?fpr=sian)**

# Changelog

This Actor's version history is a separate document: https://apify.com/sian.agency/google-finance-data-scraper/changelog.md

# Actor input Schema

## `operation` (type: `string`):

Search finance instruments or retrieve one stock quote. Each successful response produces one completed record. An empty search is billed once. A failed retrieval has no finance-record charge; a separate run-start fee applies.

## `query` (type: `string`):

Search phrase for operation search. Console example only; API callers supply their query. Results are ranked suggestions and can contain related companies.

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

Exact Google Finance symbol for operation quote, for example AAPL:NASDAQ. No symbol default is applied to API calls.

## Actor input object example

```json
{
  "operation": "search",
  "query": "microsoft",
  "symbol": "MSFT:NASDAQ"
}
```

# Actor output Schema

## `googleFinanceFinanceRecords` (type: `string`):

One completed Google Finance search or quote record. JSON preserves all ranked matches and available quote values. Prices may be delayed and are not trading execution prices.

## `scrapingSummary` (type: `string`):

HTML summary showing successful and failed results with key metrics

# 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 = {
    "operation": "search",
    "query": "apple",
    "symbol": "AAPL:NASDAQ"
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/google-finance-data-scraper").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 = {
    "operation": "search",
    "query": "apple",
    "symbol": "AAPL:NASDAQ",
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/google-finance-data-scraper").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 '{
  "operation": "search",
  "query": "apple",
  "symbol": "AAPL:NASDAQ"
}' |
apify call sian.agency/google-finance-data-scraper --silent --output-dataset

```

## MCP server setup

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

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/Zua9rau536iWHg6zs/builds/wtkPs7fh0CZ8V9ioZ/openapi.json