Logo SearchApi

Google Finance API

GET   /api/v1/search?engine=google_finance
OpenAPI Initiative Download OpenAPI Spec
Deprecated Fields

The following response fields are emitted only when the legacy HTML is parsed and may be removed in a future release:

  • articles — merged into news[*].articles in the latest HTML.
  • discover_more — replaced by related_stocks.
  • knowledge_graph.tags — section was removed.
  • knowledge_graph.stats[].description — tooltip text was removed.

The Google Finance API, provides real-time access to financial market data. This API offers a wide range of information, including stock quotes, market indices, currency exchange rates, and more.

Key features of the Google Finance API include:

  • Real-time price change and historical data.
  • Quarterly and annual company financials.
  • Exchange rates for major world currencies, including cryptocurrency.
  • Top news and articles.
  • Key events impacting the price movement.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The parameter defines the query you want to search. The query can be one of the following types:

    • Stock. For example - NVDA:NASDAQ.
    • Index. For example - .DJI:INDEXDJ.
    • Mutual Fund. For example - VTSAX:MUTF.
    • Currency. For example - BTC-USD.
    • Futures. For example - GCW00:COMEX.

    Note: currencies and cryptocurrencies use a hyphen - instead of a colon : to separate the symbol from the exchange.

Localization

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the interface language of the search. Check the full list of supported Google hl languages.

Filters

  • Name
    window
    Required
    Optional
    Description

    Specifies the time period for which graph results will be returned. Available options include:

    • 1D (Default) - past 1 day.
    • 5D - past 5 days.
    • 1M - past 1 month.
    • 6M - past 6 months.
    • YTD - current year to date.
    • 1Y - past 1 year.
    • 5Y - past 5 years.
    • MAX - maximum available graph data.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_finance.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=google_finance&q=TSLA%3ANASDAQ
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_finance",
  "q": "TSLA:NASDAQ"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_AxENYzjKgR4Pcdx3D0M4GJbe",
    "status": "Success",
    "created_at": "2024-02-20T18:43:10Z",
    "request_time_taken": 1.44,
    "parsing_time_taken": 0.06,
    "total_time_taken": 1.5,
    "request_url": "https://www.google.com/finance/quote/TSLA:NASDAQ?hl=en",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_AxENYzjKgR4Pcdx3D0M4GJbe.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_AxENYzjKgR4Pcdx3D0M4GJbe"
  },
  "search_parameters": {
    "engine": "google_finance",
    "q": "TSLA:NASDAQ",
    "hl": "en"
  },
  "markets": {
    "us": [
      {
        "stock": ".DJI",
        "exchange": "INDEXDJX",
        "company": "Dow Jones Industrial Average",
        "link": "https://www.google.com/finance/quote/.DJI:INDEXDJX",
        "name": "Dow Jones",
        "price": 38554.98,
        "price_change": {
          "percentage": 0.18900236,
          "amount": -73.00781,
          "movement": "Down"
        },
        "date": "Feb 20, 01:42:57 PM UTC-05:00"
      },
      ...
    ]
    ...
  },
  "summary": {
    "title": "Tesla Inc",
    "stock": "TSLA",
    "exchange": "NASDAQ",
    "price": 190.838,
    "currency": "USD",
    "date": "Feb 20, 01:43:01 PM UTC-05:00",
    "price_change": {
      "percentage": 4.557139,
      "amount": -9.1119995,
      "movement": "Down"
    }
  },
  "graph": [
    {
      "price": 208.8,
      "currency": "USD",
      "date": "Jan 22 2024, 04:00 PM UTC-05:00",
      "volume": 117952527
    },
   ...
  ],
  "knowledge_graph": {
    "stats": [
      {
        "label": "Previous close",
        "value": "$199.95"
      },
      ...
    ],
    "about": {
      "company": "Tesla",
      "description": "Tesla, Inc. is an American multinational automotive and clean energy company headquartered in Austin, Texas, which designs, manufactures and sells electric vehicles, stationary battery energy storage devices from home to grid-scale, solar panels and solar shingles, and related products and services.",
      "founded": "Jul 01 2003",
      "ceo": "Elon Musk",
      "employees": 140473,
      "website": "https://www.tesla.com/",
      "wikipedia": "https://en.wikipedia.org/wiki/Tesla,_Inc."
    }
  },
  "news": [
    {
      "title": "News stories",
      "articles": [
        {
          "title": "Cybertruck engineer addresses claims the Tesla EVs rust in rain",
          "source": "Business Insider",
          "date": "1 day ago",
          "link": "https://www.businessinsider.com/cybertruck-engineer-addresses-claims-the-tesla-evs-rust-in-rain-2024-2",
          "favicon": "https://encrypted-tbn3.gstatic.com/faviconV2?url=https://www.businessinsider.com&client=FINANCE_HUB&size=32&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
        },
        ...
      ]
    }
  ],
  "financials": {
    "quarterly": [
      {
        "year": 2023,
        "quarter": 3,
        "currency": "USD",
        "revenue": {
          "value": 23350000000,
          "last_year_value": 21454000000,
          "price_change": {
            "percentage": 8.8375,
            "amount": 1896000000,
            "movement": "Up"
          }
        },
        "net_income": {
          "value": 1853000000,
          "last_year_value": 3292000000,
          "price_change": {
            "percentage": 43.712,
            "amount": -1439000000,
            "movement": "Down"
          }
        },
        "earnings_per_share": {
          "value": 0.53,
          "last_year_value": 0.95,
          "price_change": {
            "percentage": 44.2105,
            "amount": -0.41999999999999993,
            "movement": "Down"
          }
        },
        ...
      },
     ...
    ],
    "annual": [
      {
        "year": 2022,
        "currency": "USD",
        "revenue": {
          "value": 81462000000,
          "last_year_value": 53823000000,
          "price_change": {
            "percentage": 51.3517,
            "amount": 27639000000,
            "movement": "Up"
          }
        },
        "net_income": {
          "value": 12556000000,
          "last_year_value": 5519000000,
          "price_change": {
            "percentage": 127.505,
            "amount": 7037000000,
            "movement": "Up"
          }
        },
        ...
      },
      ...
    ]
  },
  "compare_to": [
    {
      "stock": "AAPL",
      "exchange": "NASDAQ",
      "company": "Apple Inc",
      "link": "https://www.google.com/finance/quote/AAPL:NASDAQ",
      "name": "Apple Inc",
      "price": 180.815,
      "price_change": {
        "percentage": 0.82002914,
        "value": -1.4949951,
        "movement": "Down"
      },
      "date": "Feb 20, 01:42:40 PM UTC-05:00"
    },
   ...
  ],
  "discover_more": [
    {
      "title": "Related stocks",
      "items": [
        {
          "stock": "AAPL",
          "link": "https://www.google.com/finance/quote/AAPL:NASDAQ",
          "name": "Apple Inc",
          "price": 180.815,
          "price_change": {
            "percentage": 0.82,
            "movement": "Down"
          }
        },
       ...
      ]
    }
  ],
  "related_stocks": [
    {
      "stock": "AAPL",
      "link": "https://www.google.com/finance/quote/AAPL:NASDAQ",
      "name": "Apple Inc",
      "price": 180.815,
      "price_change": {
        "percentage": 0.82,
        "movement": "Down"
      }
    },
    ...
  ],
  "lists": [
    {
      "title": "Equity sectors",
      "items": [
        {
          "stock": "SIXB",
          "name": "Materials",
          "price": 1092.80,
          "price_change": {
            "percentage": -0.71,
            "amount": -7.77,
            "movement": "Down"
          },
          "previous_close": 1100.57,
          "open": 1098.94,
          "high": 1103.80,
          "low": 1084.24
        },
        ...
      ]
    }
  ]
}

News & Articles

News & Articles
GET
https://www.searchapi.io/api/v1/search?engine=google_finance&q=BTC-USD
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_finance",
  "q": "BTC-USD"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "news": [
    {
      "title": "News stories",
      "articles": [
        {
          "title": "BTC/USD Forex Signal 29/04",
          "link": "https://www.dailyforex.com/forex-technical-analysis/2026/04/btcusd-signal-29-april-2026/244522",
          "source": "DailyForex",
          "date": "34 minutes ago",
          "favicon": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.dailyforex.com&client=FINANCE_HUB&size=32&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
        },
        {
          "title": "Bitcoin Price Forecast: BTC-USD Targets $82,700 if $76,800 Support Holds",
          "link": "https://www.tradingnews.com/news/bitcoin-price-forecast-btc-usd-eyes-82700-usd-target-if-76k-usd",
          "source": "TradingNEWS",
          "date": "15 hours ago",
          "favicon": "https://encrypted-tbn0.gstatic.com/faviconV2?url=https://www.tradingnews.com&client=FINANCE_HUB&size=32&type=FAVICON&fallback_opts=TYPE,SIZE,URL"
        },
        "..."
      ]
    }
  ]
}

Market & Summary

Market & Summary
GET
https://www.searchapi.io/api/v1/search?engine=google_finance&q=EUR-USD
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_finance",
  "q": "EUR-USD"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "markets": {
    "us": [
      {
        "stock": ".DJI",
        "exchange": "INDEXDJX",
        "company": "Dow Jones Industrial Average",
        "link": "https://www.google.com/finance/quote/.DJI:INDEXDJX",
        "name": "Dow Jones",
        "price": 38542.75,
        "price_change": {
          "percentage": 0.22066456,
          "amount": -85.23828,
          "movement": "Down"
        },
        "date": "Feb 20, 02:03:27 PM UTC-05:00"
      },
      ...
    ],
    "europe": [...],
    "asia": [...],
    ...
  },
  "summary": {
    "title": "EUR / USD",
    "price": 1.08084,
    "date": "Feb 20, 07:04:00 PM UTC+00:00",
    "price_change": {
      "percentage": 0.3099767981438627,
      "amount": 0.003340000000000121,
      "movement": "Up"
    }
  }
}

Compare To

Compare To
GET
https://www.searchapi.io/api/v1/search?engine=google_finance&q=EUR-USD
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_finance",
  "q": "EUR-USD"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "compare_to": [
    {
      "company": "JPY / USD",
      "link": "https://www.google.com/finance/quote/JPY-USD",
      "name": "JPY / USD",
      "price": 0.0066671555,
      "price_change": {
        "percentage": 0.1909323835929302,
        "amount": 0.00001270549999999974,
        "movement": "Up"
      },
      "date": "Feb 20, 07:04:00 PM UTC+00:00"
    },
   ...
  ]
}

Lists

Lists
GET
https://www.searchapi.io/api/v1/search?engine=google_finance&q=AAPL%3ANASDAQ
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_finance",
  "q": "AAPL:NASDAQ"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "lists": [
    {
      "title": "Equity sectors",
      "items": [
        {
          "stock": "SIXB",
          "name": "Materials",
          "price": 1092.80,
          "price_change": {
            "percentage": -0.71,
            "amount": -7.77,
            "movement": "Down"
          },
          "previous_close": 1100.57,
          "open": 1098.94,
          "high": 1103.80,
          "low": 1084.24
        },
        {
          "stock": "SIXC",
          "name": "Communications",
          "price": 604.74,
          "price_change": {
            "percentage": -0.07,
            "amount": -0.41,
            "movement": "Down"
          },
          "previous_close": 605.15,
          "open": 605.15,
          "high": 606.69,
          "low": 602.76
        },
        {
          "stock": "SIXE",
          "name": "Energy",
          "price": 1214.80,
          "price_change": {
            "percentage": 1.64,
            "amount": 19.61,
            "movement": "Up"
          },
          "previous_close": 1195.19,
          "open": 1204.71,
          "high": 1221.69,
          "low": 1204.71
        },
       ...
      ]
    }
  ]
}