Quickstart - Google AI Mode API - HasData Documentation

The Google AI Mode SERP API captures Gemini-powered AI responses from Google Search. Get structured, conversational answers with links, summaries, and subtopic breakdowns—ideal for next-gen search and content tools.

Get Your API Key

Sign in at hasdata.com, 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 AI Mode 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.

You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.

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.

Make Your First Request

curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/google/ai-mode' \
  --data-urlencode 'q=Is coffee good for health?' \
  --data-urlencode 'location=Austin,Texas,United States' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

hasdata google-ai-mode \
  --q 'Is coffee good for health?' \
  --location 'Austin,Texas,United States'

const axios = require('axios').default;

const options = {
  method: 'GET',
  url: 'https://api.hasdata.com/scrape/google/ai-mode',
  params: {q: 'Is coffee good for health?', location: 'Austin,Texas,United States'},
  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);
}

import requests

url = "https://api.hasdata.com/scrape/google/ai-mode"

querystring = {"q":"Is coffee good for health?","location":"Austin,Texas,United States"}

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

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

print(response.json())

<?php

$params = [
    "q" => "Is coffee good for health?",
    "location" => "Austin,Texas,United States",
];

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hasdata.com/scrape/google/ai-mode?" . 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;

OkHttpClient client = new OkHttpClient();

HttpUrl url = HttpUrl.parse("https://api.hasdata.com/scrape/google/ai-mode")
  .newBuilder()
  .addQueryParameter("q", "Is coffee good for health?")
  .addQueryParameter("location", "Austin,Texas,United States")
  .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();

using System.Net.Http;
using System.Web;

var client = new HttpClient();

var query = HttpUtility.ParseQueryString(string.Empty);
query["q"] = "Is coffee good for health?";
query["location"] = "Austin,Texas,United States";

var url = $"https://api.hasdata.com/scrape/google/ai-mode?{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);

require 'net/http'
require 'uri'

uri = URI("https://api.hasdata.com/scrape/google/ai-mode")
params = {
  "q" => "Is coffee good for health?",
  "location" => "Austin,Texas,United States",
}
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

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/ai-mode")
        .query(&[("q", "Is coffee good for health?")])
        .query(&[("location", "Austin,Texas,United States")])
        .header("Content-Type", "application/json")
        .header("x-api-key", "<your-api-key>")
        .send()?
        .text()?;
    println!("{}", res);
    Ok(())
}

package main

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

func main() {
	params := url.Values{}
	params.Set("q", "Is coffee good for health?")
	params.Set("location", "Austin,Texas,United States")

	u := "https://api.hasdata.com/scrape/google/ai-mode?" + 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))
}

Response

{
   "requestMetadata":{
      "id":"504e446a-481a-416c-8a21-4f0f691288b4",
      "status":"ok",
      "html":"https://files.hasdata.com/7c9e6679-7425-40de-944b-e07fc1f90ae7/504e446a-481a-416c-8a21-4f0f691288b4.html",
      "url":"https://www.google.com/search?q=Is+coffee+good+for+health%3F&udm=50&uule=w%2BCAIQICIaQXVzdGluLFRleGFzLFVuaXRlZCBTdGF0ZXM%3D"
   },
   "textBlocks":[
      {
         "type":"paragraph",
         "snippet":"Whether coffee is good for your health depends on various factors, including the amount consumed and individual health conditions.However, studies increasingly suggest that coffee consumption can have significant health benefits when consumed in moderation.",
         "snippetHighlightedWords":[
            "coffee consumption can have significant health benefits when consumed in moderation"
         ]
      },
      {
         "type":"paragraph",
         "snippet":"Potential Health Benefits of Coffee:",
         "snippetHighlightedWords":[
            "Potential Health Benefits of Coffee:"
         ]
      },
      {
         "type":"list",
         "list":[
            {
               "snippet":"Reduced risk of certain diseases: Moderate coffee consumption has been linked to a reduced risk of various conditions such as Type 2 diabetes, Parkinson's disease, liver disease (including cirrhosis and liver cancer), and potentially certain types of cancer like colon and endometrial cancer."
            },
            {
               "snippet":"Improved mood and alertness: Coffee is known to enhance alertness, decrease mental fatigue, and improve mood due to its caffeine content, which acts as a stimulant."
            },
            {
               "snippet":"Protection against Alzheimer's and Parkinson's disease: Research suggests a lower risk of developing these neurodegenerative diseases in coffee drinkers."
            },
            {
               "snippet":"Heart health benefits: Contrary to past concerns, moderate coffee intake is associated with a reduced risk of heart failure and may even lower the risk of stroke."
            },
            {
               "snippet":"Rich in antioxidants: Coffee contains a significant amount of antioxidants, like polyphenols, which can help protect cells from damage and may contribute to various health benefits."
            },
            {
               "snippet":"Improved athletic performance: Caffeine can enhance athletic performance, particularly for endurance exercises."
            }
         ]
      },
      {
         "type":"paragraph",
         "snippet":"Important Considerations and Potential Drawbacks:",
         "snippetHighlightedWords":[
            "Important Considerations and Potential Drawbacks:"
         ]
      },
      {
         "type":"list",
         "list":[
            {
               "snippet":"Moderation is key: Excessive coffee consumption (often considered more than 4-5 cups per day or exceeding 400 mg of caffeine) can lead to negative side effects like increased heart rate, anxiety, restlessness, insomnia, and digestive issues."
            },
            {
               "snippet":"Individual sensitivity to caffeine varies: Some people are more sensitive to caffeine and may experience adverse effects even with moderate intake."
            },
            {
               "snippet":"Impact on sleep: Drinking coffee, especially later in the day, can interfere with sleep quality. It's generally recommended to avoid caffeine several hours before bedtime."
            },
            {
               "snippet":"Adding unhealthy ingredients: Adding excessive sugar, cream, or flavored syrups can significantly increase the calorie and sugar content, negating the potential health benefits of coffee."
            },
            {
               "snippet":"Certain health conditions: Individuals with severe anxiety, cardiovascular disease, or who are pregnant or breastfeeding should consult with their healthcare provider about caffeine consumption."
            },
            {
               "snippet":"Unfiltered coffee: Methods like French press or Turkish coffee that don't filter out cafestol, a compound found in coffee, can slightly raise LDL (bad) cholesterol levels."
            }
         ]
      },
      {
         "type":"paragraph",
         "snippet":"In summary, enjoying coffee in moderation (typically 3-5 cups per day, or up to 400 mg of caffeine) can be a part of a healthy diet for most people.However, it's essential to be mindful of individual sensitivity to caffeine, avoid excessive intake, and be aware of how you prepare your coffee to maximize its potential health benefits and minimize any negative impacts.",
         "snippetHighlightedWords":[
            "In summary, enjoying coffee in moderation (typically 3-5 cups per day, or up to 400 mg of caffeine) can be a part of a healthy diet for most people."
         ]
      }
   ],
   "references":[
      {
         "link":"https://utswmed.org/medblog/is-coffee-good-for-you/#:~:text=Drinking%20coffee%20in%20moderation%20has,for%20people%20across%20the%20world.",
         "title":"Is coffee good for you? | Diet and Nutrition",
         "snippet":"Is coffee good for you? ... Drinking coffee in moderation has been associated with a lower risk of heart failure and stroke, among other potential benefits. If ...",
         "source":"utswmed.org",
         "index":1
      },
      {
         "link":"https://www.healthline.com/nutrition/coffee-good-or-bad#:~:text=Coffee%20drinkers%20have%20a%20lower%20risk%20of%20liver%20diseases,of%20liver%20cancer%20(%2018%20).",
         "title":"Coffee — Good or Bad? - Healthline",
         "snippet":"Oct 4, 2024 — Coffee — Good or Bad? ... Coffee is a popular beverage with many health benefits, including high amounts of antioxidants. That said, its main active ingredient,",
         "source":"Healthline",
         "index":2
      },
      {
         "link":"https://www.healthline.com/nutrition/coffee-good-or-bad#:~:text=Coffee%20drinkers%20have%20a%20lower%20risk%20of%20liver%20diseases,of%20liver%20cancer%20(%2018%20).",
         "title":"Coffee — Good or Bad? - Healthline",
         "snippet":"Oct 4, 2024 — Coffee drinkers have a lower risk of liver diseases. Your liver is an incredibly important organ that has hundreds of different functions in your body. It is se...",
         "source":"Healthline",
         "index":3
      },
      {
         "link":"https://www.mayoclinic.org/healthy-lifestyle/nutrition-and-healthy-eating/in-depth/caffeine/art-20045678#:~:text=Headache,length%20of%20time%20you%20sleep.",
         "title":"Caffeine: How much is too much? - Mayo Clinic",
         "snippet":"Caffeine in powder or liquid form can provide toxic levels of caffeine, the U.S. Food and Drug Administration has cautioned. Just one teaspoon of powdered caffe...",
         "source":"Mayo Clinic",
         "index":4
      },
      {
         "link":"https://www.hopkinsmedicine.org/health/wellness-and-prevention/9-reasons-why-the-right-amount-of-coffee-is-good-for-you",
         "title":"9 Reasons Why (the Right Amount of) Coffee Is Good for You",
         "snippet":"9 Reasons Why (the Right Amount of) Coffee Is Good for You. ... Ah, coffee. Whether you're cradling a travel mug on your way to work or dashing out after spin c...",
         "source":"Johns Hopkins Medicine",
         "index":5
      },
      {
         "link":"https://www.mayoclinic.org/healthy-lifestyle/nutrition-and-healthy-eating/expert-answers/coffee-and-health/faq-20058339",
         "title":"Coffee and health: What does the research say? - Mayo Clinic",
         "snippet":"Drinking coffee with caffeine has been linked with improved mood and a lower risk of depression in some groups. Drinking 3 to 4 cups of coffee a day is linked t...",
         "source":"Mayo Clinic",
         "index":6
      },
      {
         "link":"https://www.healthline.com/nutrition/caffeine-side-effects#:~:text=Rhabdomyolysis%20is%20a%20serious%20condition,effect%20on%20the%20nervous%20system.",
         "title":"9 Side Effects of Too Much Caffeine - Healthline",
         "snippet":"Jan 13, 2025 — Here are 9 side effects of too much caffeine. * 1. Anxiety. Caffeine is known to increase alertness. It works by blocking the effects of adenosine, a brain chem...",
         "source":"Healthline",
         "index":7
      },
      {
         "link":"https://www.health.harvard.edu/staying-healthy/moderate-amounts-of-coffee-are-the-best",
         "title":"Moderate amounts of coffee are the best - Harvard Health",
         "snippet":"Nov 1, 2020 — In the journals. ... Coffee has had a hot-and-cold reputation when it comes to health benefits. Drinking two to five daily cups of coffee may protect against he...",
         "source":"Harvard Health",
         "index":8
      },
      {
         "link":"https://www.fda.gov/consumers/consumer-updates/spilling-beans-how-much-caffeine-too-much",
         "title":"Spilling the Beans: How Much Caffeine is Too Much? - FDA",
         "snippet":"Aug 28, 2024 — “Energy Drinks” and Children and Teens. ... Too much caffeine in children and teens can cause increased heart rate, heart palpitations, high blood pressure, anx...",
         "source":"U.S. Food and Drug Administration (.gov)",
         "index":9
      },
      {
         "link":"https://nutritionsource.hsph.harvard.edu/food-features/coffee/#:~:text=A%20plain%20%E2%80%9Cblack%E2%80%9D%20cup%20of,calories%20to%20your%20daily%20cup.",
         "title":"Coffee - The Nutrition Source - Harvard University",
         "snippet":"Source Of. ... One 8-ounce cup of brewed coffee contains about 95 mg of caffeine. A moderate amount of coffee is generally defined as 3-5 cups a day, or on aver...",
         "source":"The Nutrition Source",
         "index":10
      },
      {
         "link":"https://www.acc.org/About-ACC/Press-Releases/2022/03/23/17/55/Good-News-for-Coffee-Lovers-Daily-Coffee-May-Benefit-the-Heart#:~:text=Kistler%2C%20MD%2C%20professor%20and%20head,with%20benefits%20to%20heart%20health.%E2%80%9D",
         "title":"Good News for Coffee Lovers: Daily Coffee May Benefit the ...",
         "snippet":"Mar 24, 2022 — Drinking two to three cups a day was associated with greatest heart benefits * Drinking coffee—particularly two to three cups a day—is not only associated with ...",
         "source":"American College of Cardiology",
         "index":11
      },
      {
         "link":"https://hsph.harvard.edu/news/is-coffee-good-or-bad-for-your-health/#:~:text=Early%20research%20linked%20coffee%20to,Good%20for%20You%20or%20Not?",
         "title":"Is coffee good or bad for your health?",
         "snippet":"Apr 9, 2021 — Early research linked coffee to diseases ranging from heart disease and asthma. But Hu noted that many participants in those studies also smoked, which may have...",
         "source":"Harvard T.H. Chan School of Public Health",
         "index":12
      },
      {
         "link":"https://www.heartandstroke.ca/articles/myths-and-truths-about-coffee#:~:text=Truth:%20It's%20all%20about%20moderation,Learn%20more%20about:",
         "title":"Myths and truths about coffee | Heart and Stroke Foundation",
         "snippet":"Oct 20, 2024 — Does coffee cause heart disease? The answer may surprise you. ... If you start your day with coffee, you're in luck. Packed with antioxidants and hydrating flui...",
         "source":"Heart and Stroke Foundation of Canada",
         "index":13
      },
      {
         "link":"https://www.sleepfoundation.org/nutrition/caffeine-and-sleep#:~:text=Sensitivity%20to%20caffeine%20varies%20among,insomnia%2C%20anxiety%2C%20or%20headaches.",
         "title":"Caffeine and Sleep Problems - Sleep Foundation",
         "snippet":"Apr 17, 2024 — * Caffeine promotes wakefulness by blocking adenosine, a sleep-inducing chemical. * Sensitivity to caffeine varies among individuals and depends on how often it...",
         "source":"Sleep Foundation",
         "index":14
      },
      {
         "link":"https://www.ncbi.nlm.nih.gov/books/NBK519490/",
         "title":"Caffeine - StatPearls - NCBI Bookshelf",
         "snippet":"May 29, 2024 — Administration * Available Dosage Forms and Strengths. * Specific Patient Populations. * Hepatic impairment: Caffeine's product labeling does not specify dosage...",
         "source":"National Institutes of Health (NIH) | (.gov)",
         "index":15
      },
      {
         "link":"https://www.medicalnewstoday.com/articles/326443",
         "title":"Does coffee make you tired? Here's why - Medical News Today",
         "snippet":"Jun 26, 2023 — Insomnia. Share on Pinterest Drinking coffee close to bedtime may cause insomnia. People who drink coffee before going to bed may have trouble falling asleep. *",
         "source":"Medical News Today",
         "index":16
      },
      {
         "link":"https://www.piedmont.org/living-real-change/is-coffee-good-for-your-health",
         "title":"Is coffee good for your health? - Piedmont Healthcare",
         "snippet":"Here are five ways coffee may be good for your health: * 1. It lowers the risk of type 2 diabetes. A report in the American Chemical Society's Journal of Agricu...",
         "source":"Piedmont Healthcare",
         "index":17
      },
      {
         "link":"https://mcpress.mayoclinic.org/nutrition-fitness/your-morning-cup-of-coffee-may-have-unexpected-health-benefits/#:~:text=The%20bottom%20line%20on%20coffee,Hensrud.",
         "title":"Your morning cup of coffee may have unexpected health benefits",
         "snippet":"Oct 24, 2024 — Your morning cup of coffee may have unexpected health benefits * Coffee — An unexpected ally for wellness. It will likely come as no surprise that coffee can of...",
         "source":"Mayo Clinic Press",
         "index":18
      }
   ]
}

API Parameters

Parameter	Default Value	Required	Description
`q`	Is coffee good for health?	Yes	Specify the search term for which you want to scrape the SERP.
`location`	Austin,Texas,United States	No	Google canonical location for the search.
`uule`	-	No	The encoded location parameter.
`gl`	-	No	The two-letter country code for the country you want to limit the search to.

Get Started

Rich Snippets

Quickstart - Google AI Mode API

Get Your API Key

Request Cost and API Credits

Make Your First Request

API Parameters