Google Search Ai

Search for image results on Google based on keywords.

If you already know that you want to use Google Search Ai, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.

At a Glance

Field	Value
Name	Google Search Ai
Scraper	`google_ai_overview`
Engine	`google_search_ai`
Website	Google
Website URL	googlesearchai.com
Output Format	`json`
Version	`1.0.0`
Parameter Count	`2`
Parameter Groups	Search Query (1), Request Controls (1)

Request Example

This is the real request body used to validate google_ai_overview during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"google_ai_overview","q":"what is machine learning"}'

Response Example

The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:19:26 UTC",
    "id": "01KMMKKW7QAFBR3KE6HMGTCE4G",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKKW7QAFBR3KE6HMGTCE4G.json",
    "processed_at": "2026-03-26 08:19:26 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKKW7QAFBR3KE6HMGTCE4G.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "google_ai_overview",
    "q": "what is machine learning"
  },
  "total_credits_used": 1,
  "ai_overviews": {
    "references": [
      {
        "index": 1,
        "link": "https://www.youtube.com/shorts/TLP33fc1l78",
        "snippet": null,
        "source": "YouTube",
        "title": "What is Machine Learning? Explained for Beginners | AI & Data Science ..."
      },
      {
        "_note": "2 more items omitted"
      }
    ],
    "text_blocks": [
      {
        "snippet": " 'Machine learning (ML) is', 'a branch of artificial intelligence (AI) where computers are trained to identify patterns, make decisions, and generate predictions from data without being explicitly programmed for every sp... [truncated, 451 chars]",
        "type": "paragraph"
      }
    ]
  }
}

Required Parameters

If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.

Field	Type	Group	Description
`q`	`string`	Search Query	The keyword or phrase you want this search engine to look up.

Available Parameters

The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.

Search Query

Field	Type	Required	Description
`q`	`string`	Yes	The keyword or phrase you want this search engine to look up.

Request Controls

Field	Type	Required	Description
`no_cache`	`boolean`	No	Skip cached results and force a fresh fetch.

Additional Constraints

no_cache：Default: false

SERP

Engines