> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hasdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Finance API

The Google Finance API returns Google Finance quote data for a stock, index, mutual fund, ETF, currency pair, cryptocurrency or futures contract - price, price chart, key stats, company profile, news, financial statements, related tickers and the market overview.

## Get Your API Key

Sign in at [hasdata.com](https://app.hasdata.com/sign-in), go to your account settings, and copy your API key.
All requests must include your key in the `x-api-key` header.

## Request Cost and API Credits

Each request to the Google Finance API consumes **API Credits** from your account balance.

* **Cost per request:** 10 API Credits
* Credits are deducted only for successful requests.
* Your total available credits depend on your active plan.

> [!TIP]
>
> You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.

> [!WARNING]
>
> **Unused credits do not roll over.** Any remaining credits expire at the end of the current billing period.

To monitor your credit usage and remaining balance, sign in to your account dashboard at [app.hasdata.com](https://app.hasdata.com/sign-in).

## Make Your First Request

```bash cURL theme={null}
curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/google/finance' \
  --data-urlencode 'q=GOOGL:NASDAQ' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'
```

```javascript Node.js theme={null}
const axios = require('axios').default;

const options = {
  method: 'GET',
  url: 'https://api.hasdata.com/scrape/google/finance',
  params: {q: 'GOOGL:NASDAQ'},
  headers: {'Content-Type': 'application/json', 'x-api-key': '<your-api-key>'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```python Python theme={null}
import requests

url = "https://api.hasdata.com/scrape/google/finance"

querystring = {"q":"GOOGL:NASDAQ"}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "<your-api-key>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```php PHP theme={null}
<?php

$params = [
    "q" => "GOOGL:NASDAQ",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/google/finance?" . http_build_query($params),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <your-api-key>",
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;
```

```java Java theme={null}
OkHttpClient client = new OkHttpClient();

HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/google/finance")
  .newBuilder()
  .addQueryParameter("q", "GOOGL:NASDAQ")
  .build();

Request request = new Request.Builder()
  .url(url)
  .get()
  .addHeader("Content-Type", "application/json")
  .addHeader("x-api-key", "<your-api-key>")
  .build();

Response response = client.newCall(request).execute();
```

```csharp C# theme={null}
using System.Net.Http;
using System.Web;

var client = new HttpClient();

var query = HttpUtility.ParseQueryString(string.Empty);
query["q"] = "GOOGL:NASDAQ";

var url = $"https://api.hasdata.com/scrape/google/finance?{query}";

var request = new HttpRequestMessage(new HttpMethod("GET"), url);
request.Headers.Add("x-api-key", "<your-api-key>");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
```

```ruby Ruby theme={null}
require 'net/http'
require 'uri'

uri = URI("https://api.hasdata.com/scrape/google/finance")
params = {
  "q" => "GOOGL:NASDAQ",
}
uri.query = URI.encode_www_form(params)

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["Content-Type"] = 'application/json'
request["x-api-key"] = '<your-api-key>'

response = http.request(request)
puts response.read_body
```

```rust Rust theme={null}
use reqwest::blocking::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    let res = client
        .get("https://api.hasdata.com/scrape/google/finance")
        .query(&[("q", "GOOGL:NASDAQ")])
        .header("Content-Type", "application/json")
        .header("x-api-key", "<your-api-key>")
        .send()?
        .text()?;
    println!("{}", res);
    Ok(())
}
```

```go Go theme={null}
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	params := url.Values{}
	params.Set("q", "GOOGL:NASDAQ")

	u := "https://api.hasdata.com/scrape/google/finance?" + params.Encode()

	req, _ := http.NewRequest("GET", u, nil)
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("x-api-key", "<your-api-key>")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}
```

## API Parameters

| Parameter | Default Value | Required | Description |
| - | - | - | - |
| `q` | GOOGL:NASDAQ | Yes | Ticker as Google Finance writes it, e.g. `GOOGL:NASDAQ`, `.INX:INDEXSP`, `EUR-USD` or `BTC-USD`. An unknown ticker returns `suggestions`. |
| `window` | - | No | Time range of the price chart in `graph`. |
| `hl` | - | No | The two-letter language code for the language you want to use for the search. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.