AI Mode

Learn how you can extract AI Mode data with Web Scraper API.

The google_ai_mode source is designed to submit prompts and retrieve Google AI Mode conversational responses. It returns both the complete Google AI Mode response text along with its structured metadata.

AI Mode regional availability

Google AI Mode is available in most countries worldwide apart from these exceptions:

Region

Countries

Europe

France, Turkey

Asia

China, Iran, North Korea, Syria

Americas

Cuba

Google AI Mode feature is continuously rolling out with more countries included over time.

Request samples

The following code examples demonstrate how to retrieve a Google AI Mode response with parsed results.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_ai_mode",
        "query": "best health trackers under $200",
        "render": "html",
        "parse": true
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_ai_mode',
    'query': 'best health trackers under $200',
    'render': 'html',
    'parse': True
}


# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_ai_mode",
    query: "best health trackers under $200",
    render: "html",
    parse: true
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

<?php

$params = array(
    'source' => 'google_ai_mode',
    'query' => 'best health trackers under $200',
    'render' => 'html',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

  	payload := map[string]interface{}{
        	"source": "google_ai_mode",
        	"query": "best health trackers under $200",
        	"render": "html",
        	"parse":  true,
    	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new
            {
                source = "google_ai_mode",
                query = "best health trackers under $200",
                render = "html",
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "google_ai_mode");
        jsonObject.put("query", "best health trackers under $200");
        jsonObject.put("render", "html");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

Our examples use synchronous Realtime integration method. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Basic setup and customization options for retrieving Google AI Mode responses.

Parameter

Description

Default Value

source

Sets the scraper.

google_ai_mode

query

The prompt or question to submit to Google AI Mode. Must be less than 400 symbols.

render

Setting to html is required for this source. More info.

parse

Returns parsed data when set to true.

false

geo_location

The geographical location that the result should be adapted for. For more information, read about our suggested geo_location parameter structures here.

callback_url

URL to your callback endpoint. More info.

- mandatory parameter

Structured data

Web Scraper API returns either an HTML or JSON object of Google AI Mode output, containing structured data of the results page.

google_ai_mode structured output

{
    "results": [
        {
            "content": {
                "links": [
                    {
                        "url": "https://www.nytimes.com/wirecutter/reviews/the-best-fitness-trackers/#:~:text=%7C,Apple%20users:%20Apple%20Watch%20SE",
                        "text": "The 3 Best Fitness Trackers of 2025 | Reviews by Wirecutter"
                    },
                    {
                        "url": "https://www.wareable.com/fitness-trackers/the-best-fitness-tracker#:~:text=Fitbit%20Charge%206%20%E2%80%93%20the%20best,10%20%E2%80%93%20Best%20fitness%2Dtracking%20smartwatch",
                        "text": "Best fitness tracker 2025: Reviewed, tested and compared"
                    },
                    {
                        "url": "https://www.techradar.com/best/best-cheap-fitness-trackers",
                        "text": "The best cheap fitness trackers for 2025 - TechRadar"
                    },
                    {
                        "url": "https://www.livescience.com/best-budget-fitness-tracker",
                        "text": "Best budget fitness trackers 2025: Hand-picked by our expert reviewers"
                    },
                    {
                        "url": "https://www.garagegymreviews.com/best-budget-fitness-tracker",
                        "text": "Expert-Tested: Best Budget Fitness Tracker (2025)"
                    },
                    {
                        "url": "https://www.businessinsider.com/guides/tech/best-fitbit#:~:text=Our%20top%20recommendation%20is%20the,fitness%20tools%20for%20under%20%24100.",
                        "text": "The Best Fitbit in 2025 - Business Insider"
                    },
                    {
                        "url": "https://medium.com/@kellyshephard/best-smartwatches-under-200-5961cbc1a6f8#:~:text=The%20Apple%20Watch%20SE%20(2022)%20is%20the,it%20still%20performs%20well%20throughout%20the%20day.",
                        "text": "Best Smartwatches Under $200 in 2025: Tested and Approved"
                    },
                    {
                        "url": "https://www.gminsights.com/industry-analysis/smartwatch-market#:~:text=More%20advanced%20functions%20such%20as%20ECG%20monitoring%2C,Galaxy%20Watch%205%2C%20and%20Fitbit%20Sense%202.",
                        "text": "Smartwatch Market Share, Growth Analysis Report 2025-2034"
                    },
                    {
                        "url": "https://www.linkedin.com/pulse/best-smartwatches-law-enforcement-rugged-reliable-ready-samar-abbas-n1bif#:~:text=Q6:%20What's%20the%20best%20smartwatch%20for%20health,especially%20for%20VO2%20Max%20and%20stress%20levels.",
                        "text": "Best Smartwatches for Law Enforcement: Rugged, Reliable, and Ready for Duty"
                    },
                    {
                        "url": "https://gearjunkie.com/health-fitness/best-fitness-watch#:~:text=Technology%20for%20health%20tracking%20has%20advanced%20a,and%20infrared%20light)%20and%20Heart%20Rate%20Variability.",
                        "text": "The Best Fitness Watches of 2025"
                    }
                ],
                "prompt": "best health trackers under $200",
                "citations": [
                    {
                        "text": "Tracker",
                        "urls": [
                            "https://www.nytimes.com/wirecutter/reviews/the-best-fitness-trackers/#:~:text=%7C,Apple%20users:%20Apple%20Watch%20SE",
                            "https://www.livescience.com/best-budget-fitness-tracker",
                            "https://www.techradar.com/best/best-cheap-fitness-trackers"
                        ]
                    },
                    {
                        "text": "Tracking accuracy: Reputable brands like Fitbit and Garmin offer reliable accuracy for tracking heart rate, steps, and sleep. More advanced metrics like blood oxygen (SpO2) and stress are also available on many models. GPS: For runners and cyclists, having built-in GPS is crucial for mapping routes and tracking distance without carrying a phone. If you don't need this, or are comfortable relying on your phone's GPS, you can save money with a tracker that lacks this feature. Subscription services: Brands like Fitbit offer a premium membership to unlock more detailed insights and guided programs. However, all trackers on this list provide basic tracking for free. Battery life: Simpler trackers typically last a week or more on a single charge, while more complex smartwatches like the Apple Watch SE need daily charging . Design and comfort: Consider the size and style of the tracker. Some prefer the compact, lightweight design of a basic band, while others like the larger, more interactive display of a smartwatch.",
                        "urls": [
                            "https://www.nytimes.com/wirecutter/reviews/the-best-fitness-trackers/#:~:text=%7C,Apple%20users:%20Apple%20Watch%20SE",
                            "https://www.wareable.com/fitness-trackers/the-best-fitness-tracker#:~:text=Fitbit%20Charge%206%20%E2%80%93%20the%20best,10%20%E2%80%93%20Best%20fitness%2Dtracking%20smartwatch"
                        ]
                    }
                ],
                "response_text": "For under $200, the best health trackers include the Fitbit Inspire 3 for overall value, the Xiaomi Smart Band 9 as the best ultra-budget option, and the Apple Watch SE (2nd generation) for iPhone users. Other strong contenders include the more advanced Fitbit Charge 6 and the Garmin Vivosmart 5 . Comparison of best health trackers under $200 Tracker Best for Built-in GPS Features Pros Cons Fitbit Inspire 3 Best overall and for beginners No (uses phone GPS) 24/7 heart rate, SpO2, sleep tracking, Active Zone Minutes Excellent value , unobtrusive design, long battery life (up to 10 days) Subscription required for more detailed insights; small screen Fitbit Charge 6 More advanced tracking Yes Built-in GPS, ECG, stress tracking, EDA sensor for stress, Google Wallet/Maps Accurate heart rate tracking, includes useful Google integrations Requires a Google account ; some features are locked behind a subscription Xiaomi Smart Band 9 Best ultra-budget option No (uses phone GPS) Heart rate, SpO2, sleep tracking, 150+ workout modes Extremely affordable, large screen, excellent battery life (up to 21 days) Some users report patchy app connectivity and inconsistent accuracy Garmin Vivosmart 5 Best from Garmin No (uses phone GPS) Body Battery energy monitor, sleep tracking, SpO2, automatic activity tracking Lightweight and comfortable, particularly good sleep tracking Monochrome screen and no built-in GPS Apple Watch SE (2nd Gen) Best for iPhone users Yes Heart rate, Activity Rings, fall detection, app ecosystem Seamless integration with iPhone; vibrant screen Battery life is short (up to 18 hours); more expensive Fitbit Inspire 3 Health & Fitness Activity Tracker Black with Workout Intensity R$646.00 4.4 (5K+) XIAOMI SMART BAND 9 - Midnight Black R$237.07 (Rs\u00a012,499.00) 4.8 (7K+) Apple Watch SE GPS + Cellular 40mm Midnight Aluminium Case with Midnight Sport Band - M/L R$184.11/mo x 18 4.6 (9K+) Fitbit Charge 6 Activity and Fitness Tracker with Google apps R$832.34 ($156.00) 4.2 (5K+) Garmin Vivosmart 5, Black S/m (010-02645-00) R$800.27 ($149.99) 4.2 (2K+) See more Key features to consider Tracking accuracy: Reputable brands like Fitbit and Garmin offer reliable accuracy for tracking heart rate, steps, and sleep. More advanced metrics like blood oxygen (SpO2) and stress are also available on many models. GPS: For runners and cyclists, having built-in GPS is crucial for mapping routes and tracking distance without carrying a phone. If you don't need this, or are comfortable relying on your phone's GPS, you can save money with a tracker that lacks this feature. Subscription services: Brands like Fitbit offer a premium membership to unlock more detailed insights and guided programs. However, all trackers on this list provide basic tracking for free. Battery life: Simpler trackers typically last a week or more on a single charge, while more complex smartwatches like the Apple Watch SE need daily charging . Design and comfort: Consider the size and style of the tracker. Some prefer the compact, lightweight design of a basic band, while others like the larger, more interactive display of a smartwatch. Thank you Your feedback helps Google improve. See our Privacy Policy . Share more feedback Report a problem Close",
                "parse_status_code": 12000
            },
            "created_at": "2025-10-28 14:41:42",
            "updated_at": "2025-10-28 14:41:59",
            "page": 1,
            "url": "https://www.google.com/search?udm=50&q=best+health+trackers+under+$200&hl=en&sei=KtYAaaHbBZ_m1sQP0IOaqQg&mstk=AUtExfAUpaUCxnFayf6G4-kNkwNbm0bQCoQ9U98qUnjI2A0E7T5DCKi2lmolJe5o9X9h3tJVH-Cx91tGJrhIiDPrrcvO4kX8vex4rnW_IUsQA-b6EGmpCtqj2ocY-FWO95EcMcaYeOvsQhtFqGdYF4CChex2n6h4PeopuL0&csuir=1",
            "job_id": "7388948081053534209",
            "is_render_forced": false,
            "status_code": 200,
            "type": "parsed",
            "parser_type": "",
            "parser_preset": null
        }
    ],
    "job": {
        "callback_url": null,
        "client_id": 12345,
        "context": [
            {
                "key": "force_headers",
                "value": false
            },
            {
                "key": "force_cookies",
                "value": false
            },
            {
                "key": "hc_policy",
                "value": true
            },
            {
                "key": "successful_parse_status_codes",
                "value": []
            }
        ],
        "created_at": "2025-10-28 14:41:42",
        "domain": "com",
        "geo_location": null,
        "id": "7388948081053534209",
        "limit": 10,
        "locale": null,
        "pages": 1,
        "parse": true,
        "parser_type": null,
        "parser_preset": null,
        "parsing_instructions": null,
        "browser_instructions": null,
        "render": "html",
        "xhr": false,
        "markdown": false,
        "url": null,
        "query": "best health trackers under $200",
        "source": "google_ai_mode",
        "start_page": 1,
        "status": "done",
        "storage_type": null,
        "storage_url": null,
        "subdomain": "www",
        "content_encoding": "utf-8",
        "updated_at": "2025-10-28 14:41:59",
        "user_agent_type": "desktop",
        "session_info": null,
        "statuses": [],
        "client_notes": null,
        "_links": [
            {
                "rel": "self",
                "href": "http://data.oxylabs.io/v1/queries/7388948081053534209",
                "method": "GET"
            },
            {
                "rel": "results",
                "href": "http://data.oxylabs.io/v1/queries/7388948081053534209/results",
                "method": "GET"
            },
            {
                "rel": "results-content",
                "href_list": [
                    "http://data.oxylabs.io/v1/queries/7388948081053534209/results/1/content"
                ],
                "method": "GET"
            },
            {
                "rel": "results-html",
                "href": "http://data.oxylabs.io/v1/queries/7388948081053534209/results?type=raw",
                "method": "GET"
            },
            {
                "rel": "results-content-html",
                "href_list": [
                    "http://data.oxylabs.io/v1/queries/7388948081053534209/results/1/content?type=raw"
                ],
                "method": "GET"
            },
            {
                "rel": "results-parsed",
                "href": "http://data.oxylabs.io/v1/queries/7388948081053534209/results?type=parsed",
                "method": "GET"
            },
            {
                "rel": "results-content-parsed",
                "href_list": [
                    "http://data.oxylabs.io/v1/queries/7388948081053534209/results/1/content?type=parsed"
                ],
                "method": "GET"
            }
        ]
    }
}

The composition of elements may vary depending on whether the query was made from a desktop or mobile device.

Output data dictionary

HTML example

JSON structure

The structured google_ai_mode output includes fields like URL, page, results, and more. The table below presents a detailed list of each Google AI Mode element we parse, including description, data type, and relevant metadata.

The number of items and fields for a specific result type may vary depending on the search query.

Key Name

Description

Type

url

The URL of Google AI Mode.

string

page

Page number.

integer

content

An object containing the parsed Google AI Mode response data.

object

content.links

List of external links referenced in the response. Displayed in the box on the right side of the page.

array

content.prompt

Original prompt submitted to Google AI Mode.

string

content.citations

List of citations with URLs and associated texts, as shown in the main block of the Google AI Mode response. Multiple URLs referencing the same text are grouped together into a list.

array

content.response_text

Complete response text from Google AI Mode.

string

content.parse_status_code

Status code of the parsing operation.

integer

created_at

Timestamp when the scraping job was created.

timestamp

updated_at

Timestamp when the scraping job was finished.

timestamp

job_id

ID of the job associated with the scraping job.

string

status_code

Status code of the scraping job. You can see the scraper status codes described here.

integer

PreviousGoogle Suggest NextAI Overviews

Last updated 1 month ago

Was this helpful?

Good evening

AI Mode regional availability

Request samples

Request parameter values

Structured data

Output data dictionary

HTML example

JSON structure