# Get Complete Stock Quote

Use the Google Finance quote API when you need a single ticker-level response for a stock, ETF, or other Google Finance instrument. The endpoint returns current price fields, market status, previous close, day range, year range, market cap, P/E ratio, dividend yield, company profile details, financial statement rows, related news, and discovery tickers as structured JSON.

This page is built for developers comparing stock quote APIs, finance quote JSON endpoints, and Google Finance data extraction workflows. Start with [Search Financial Instruments](/docs/google-finance-api/google_finance_search) when you only know a company name, then call this quote endpoint with the resolved symbol and exchange. Pair quote data with [Historical Data](/docs/google-finance-api/google_finance_historical) for backtests, [Intraday Graph Data](/docs/google-finance-api/google_finance_intraday) for charting, and [Markets Overview](/docs/google-finance-api/google_finance_markets) for broader market context.

- **Documentation:** [https://scrappa.co/docs/google-finance-api/google_finance_quote](https://scrappa.co/docs/google-finance-api/google_finance_quote)
- **API group:** Google Finance API
- **Endpoint:** `GET https://scrappa.co/api/google-finance/quote`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | Stock symbol (e.g., AAPL) |
| `exchange` | string | No | Exchange code (e.g., NASDAQ). If not provided, the API will attempt to auto-resolve via an internal search. This adds latency and may fail for less common symbols. |
| `period_type` | string | No | Filter financials by period: quarterly or annual (default: returns visible data, typically quarterly) |
| `hl` | string | No | Language code (default: en) |
| `gl` | string | No | Country code (default: us) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/google-finance/quote?symbol=AAPL&exchange=NASDAQ"
```

## Example response

```json
{
    "quote": {
        "summary": {
            "name": "Apple Inc",
            "symbol": "AAPL",
            "exchange": "NASDAQ",
            "current_price": "255.78",
            "price_change": "-5.95",
            "percent_change": "-2.27%",
            "currency": "USD",
            "market": {
                "trading": "Closed",
                "price": "255.30",
                "extracted_price": 255.3,
                "price_movement": {
                    "percentage": 0.19,
                    "movement": "Up"
                }
            },
            "extensions": [
                "Closed: Feb 13, 8:00:00 PM UTC-5",
                "USD",
                "NASDAQ"
            ]
        },
        "key_stats": {
            "previous_close": "$261.73",
            "day_range": "$255.45 - $262.23",
            "year_range": "$169.21 - $288.61",
            "market_cap": "3.76T USD",
            "avg_volume": "53.72M",
            "pe_ratio": "32.36",
            "dividend_yield": "0.41%",
            "primary_exchange": "NASDAQ",
            "climate_change": {
                "score": "A",
                "link": "https://cdp.net/..."
            },
            "stats": [],
            "tags": []
        },
        "about": {
            "description": "Apple Inc. is an American multinational technology company...",
            "ceo": "Tim Cook",
            "founded": "Apr 1, 1976",
            "headquarters": "Cupertino, California",
            "employees": "166,000",
            "website": null,
            "info": []
        },
        "financials": [
            {
                "title": "Income Statement",
                "results": [
                    {
                        "date": "Dec 2025",
                        "period_type": "Quarterly",
                        "table": [
                            {
                                "title": "Revenue",
                                "description": "The total amount...",
                                "value": "143.76B",
                                "change": "15.65%"
                            },
                            {
                                "title": "Net income",
                                "description": "Company earnings...",
                                "value": "42.10B",
                                "change": "15.87%"
                            }
                        ]
                    }
                ]
            }
        ],
        "news": [
            {
                "title": "Here's Why Apple (AAPL) is a Great Momentum Stock to Buy",
                "link": "https://www.nasdaq.com/...",
                "source": "Nasdaq",
                "date": "1 day ago",
                "iso_date": "2025-02-13T12:00:00+00:00",
                "thumbnail": "https://..."
            }
        ],
        "discover_more": [
            {
                "title": "You may be interested in",
                "items": [
                    {
                        "stock": "AMZN:NASDAQ",
                        "name": "Amazon.com Inc",
                        "price": "$198.79",
                        "extracted_price": 198.79,
                        "currency": "USD",
                        "price_movement": {
                            "percentage": 0.41,
                            "movement": "Up"
                        }
                    }
                ]
            }
        ]
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Missing required symbol parameter |  |
|  | Google Finance request failed |  |

## Frequently asked questions

### What does the Google Finance quote API return?

The quote endpoint returns structured JSON for a ticker, including current price fields, market status, key statistics, company profile data, financial statement rows, recent news, and related ticker suggestions when Google Finance exposes them.

### When should I use quote instead of historical or intraday data?

Use the quote endpoint for the latest ticker profile and summary data. Use the historical endpoint for daily price and volume history, and the intraday endpoint when your application needs minute-level graph points.

### Do I need the exchange code for a stock quote request?

Passing the exchange code, such as NASDAQ for AAPL, is recommended because it avoids ambiguity and reduces lookup latency. If you only know a company name or symbol, use Search Financial Instruments first.

## Related endpoints

- [Search Financial Instruments](https://scrappa.co/docs/google-finance-api/google_finance_search)
- [Google Finance Historical Data API](https://scrappa.co/docs/google-finance-api/google_finance_historical)
- [Get Intraday Graph Data](https://scrappa.co/docs/google-finance-api/google_finance_intraday)
- [Get Markets Overview](https://scrappa.co/docs/google-finance-api/google_finance_markets)

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)