Features

A detailed overview of the Google AI Mode Scraper’s advanced capabilities, including Web Search mode, geographic targeting, citation extraction, and follow-up prompts.

The Google AI Mode Scraper provides powerful customization options to help you generate more accurate, contextual, and verifiable responses from Google AI Mode. These features allow you to tailor how Google AI Modebehaves, what type of responses it returns, and how much detail it extracts.

---

Geolocation

Control and influence Google AI Mode’s responses based on a target geographic region. Geolocation parameters affect examples, perspectives, terminology, and localized insights within the generated answer.

Geolocation supports country-level and state / city-level targeting.

---

Country

Influence Google AI Mode’s responses by specifying a target country.

This can affect examples, perspectives, or localized insights within the answer.

Country format The country value must be a 2-letter country code.

Example

{
  "prompt": "Trending products in 2025",
  "engine":"google-ai-mode",
  "country": "ca"
}

Use Cases

• Localized content generation

• Region-specific trend insights

• Country-influenced context within Google AI Mode answers

---

State and City

Refine geolocation further by targeting a specific state or state + city.

The state_city parameter allows you to influence responses with more granular regional context, such as local brands, stores, events, or regulations.

Important The country parameter is required when using state_city.

State / City format

• State only

• State and city

• State + City must be separated by underscore

Examples

State only

{
  "prompt": "Trending products in 2025",
  "country": "us",
  "state_city": "california"
}

State and city

{
  "prompt": "Trending products in 2025",
  "country": "us",
  "state_city": "california_losangeles"
}

Use Cases

• Hyper-local trend analysis

• City-specific product or business insights

• Location-aware content and recommendations

---

Error Handling

The AI Mode Scraper includes standardized error responses.

400 — Validation Errors

Returned when:

• Prompt missing

• Invalid parameter

• Prompt > 4096 characters

Example:

{
  "message": "Prompt exceeds 4096 characters. Please shorten your prompt.",
  "error": "Bad Request",
  "statusCode": 400
}

---

401 — Credentials Error

Returned when:

• Username or Password is Incorrect

• No Active Package for the Product

Example:

{
    "message": "Request failed with status code 401"
}

---

500 — Internal Errors

Every Error of a Scraping error will return a 500 error code like so:

{
  "message": "Google AI Mode scraper could not complete the request. Please try again.",
  "error": "Internal Scraper Error",
  "statusCode": 500
}