> ## 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 Gemini Scraper API

The Google Gemini Scraper API sends a prompt to Google Gemini and returns the answer as markdown text, together with the web sources Gemini cited and any images it showed. No Google account is needed, and a conversation can be continued across requests.

> [!NOTE]
>
> HasData is an independent service and is not affiliated with, endorsed by, or sponsored by Google Gemini. Google Gemini is a trademark of its respective owner. This API works with publicly available data only.

## 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 Gemini Scraper 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/gemini/chat' \
  --data-urlencode 'prompt=What are the best-rated things to do in Buenos Aires?' \
  --data-urlencode 'hl=en-US' \
  --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/gemini/chat',
  params: {prompt: 'What are the best-rated things to do in Buenos Aires?', hl: 'en-US'},
  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/gemini/chat"

querystring = {"prompt":"What are the best-rated things to do in Buenos Aires?","hl":"en-US"}

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 = [
    "prompt" => "What are the best-rated things to do in Buenos Aires?",
    "hl" => "en-US",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/gemini/chat?" . 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/gemini/chat")
  .newBuilder()
  .addQueryParameter("prompt", "What are the best-rated things to do in Buenos Aires?")
  .addQueryParameter("hl", "en-US")
  .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["prompt"] = "What are the best-rated things to do in Buenos Aires?";
query["hl"] = "en-US";

var url = $"https://api.hasdata.com/scrape/gemini/chat?{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/gemini/chat")
params = {
  "prompt" => "What are the best-rated things to do in Buenos Aires?",
  "hl" => "en-US",
}
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/gemini/chat")
        .query(&[("prompt", "What are the best-rated things to do in Buenos Aires?")])
        .query(&[("hl", "en-US")])
        .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("prompt", "What are the best-rated things to do in Buenos Aires?")
	params.Set("hl", "en-US")

	u := "https://api.hasdata.com/scrape/gemini/chat?" + 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 |
| - | - | - | - |
| `prompt` | What are the best-rated things to do in Buenos Aires? | Yes | The question or instruction to send to Google Gemini, up to 8000 characters. A prompt that asks about recent events makes Gemini search the web and return sources; a general-knowledge prompt is answered from the model alone. The prompt also decides the language of the answer — write it in the language you want back, or ask for one explicitly. |
| `hl` | en-US | No | Interface language for the answer, as a BCP-47 locale such as `en-US` or `de-DE`. The answer language also follows the language of the prompt. |
| `subsequentRequestToken` | - | No | Token returned in a previous answer as `subsequentRequestToken`. Pass it back to continue that conversation, so Gemini answers the new prompt with the earlier turns in context. Omit it to start a fresh conversation. |


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