# Google AI Mode

The LLM Scraper enables retrieval of Google AI Mode responses and returns a structured JSON output.

***

### **API Setup**

#### **Endpoint**

```
https://llm-scraper.netnut.io/search
```

***

### **Authentication**

Use HTTP Basic Authentication:

```
Authorization: Basic <base64(username:password)>
```

Where `<base64(username:password)>` is the Base64-encoded string of your NetNut credentials.

***

### **Request Body Schema**

```json
{
  "prompt": "Explain SEO ranking factors in 2025",   // Required
  "engine": "google-ai-mode",                        // Required
  "country": "us",                                   // Optional
  "throttling": true                                 // Optional, default true
}
```

#### **Field Descriptions**

| Field          | Description                                                                                                                                                                 | Parameter Type             |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **prompt**     | Main prompt sent to ChatGPT. Max length: 4096 chars.                                                                                                                        | Required                   |
| **engine**     | The chatbot engine to use. Currently supported.                                                                                                                             | Required(default: chatgpt) |
| **country**    | Target geographic region for contextual responses.                                                                                                                          | Optional                   |
| **throttling** | Controls automated throttling behavior. Enabled by default to help maintain a high success rate during heavy traffic or platform-side limitations. Set to false to opt out. | Optional (default: true)   |

***

### **Example Usage**

{% tabs %}
{% tab title="cURL" %}

```bash
curl -X POST https://llm-scraper.netnut.io/search \
  -H "Content-Type: application/json" \
  -U "username:password" \
  -d '{
    "prompt": "Give me SEO trends for 2025",
    "engine": "google-ai-mode",
    "country": "uk",
    "throttling": true
  }'

```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from base64 import b64encode

headers = {
    "Authorization": "Basic " + b64encode(b"username:password").decode(),
    "Content-Type": "application/json"
}

body = {
    "prompt": "Give me SEO trends for 2025",
    "country": "us",
    "engine": "google-ai-mode",
}

response = requests.post("https://llm-scraper.netnut.io/search", headers=headers, json=body)
print(response.json())

```

{% endtab %}

{% tab title="JavaScript" %}

```javascript
const username = 'your_username';
const password = 'your_password';
const auth = Buffer.from(`${username}:${password}`).toString('base64');

const headers = {
  'Authorization': `Basic ${auth}`,
  'Content-Type': 'application/json'
};

const body = {
  prompt: 'Give me SEO trends for 2025', 
  engine: "google-ai-mode",
  country: 'us'
};

fetch('https://llm-scraper.netnut.io/search', {
  method: 'POST',
  headers: headers,
  body: JSON.stringify(body)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error.message));
```

{% endtab %}
{% endtabs %}

***

### **Response Format**

The ChatGPT Scraper always returns **structured JSON**.\
No HTML is returned.

#### **Example JSON Response**

```json
{
    "timestamp": "2026-01-28T12:54:34.613Z",
    "traceID": "aaa11111-2bbb-1234-a1b2-83f481f038bc",
    "request_duration": 11.84,
    "process_duration": 11.84,
    "scraper": "Google-AI-Mode",
    "response": {
        "prompt": "what are the leading SEO tips in 2025",
        "text": "In 2025, SEO has shifted from purely chasing rankings to building a \"revenue engine\". Success now depends on providing human-first, expert content that survives AI summarization and adapts to a fragmented search landscape. Search Engine Land +2\n\n1. Master AI-Specific SEO\nTarget Zero-Click Results: Optimize for \"AI Overviews\" and featured snippets by providing direct, concise answers (40–60 words) immediately below question-based headers.\nConversational Keywords: Shift from \"trophy\" keywords to long-tail, natural-language queries that users ask AI tools like ChatGPT or Perplexity.\nMultimodal Optimization: Use Schema.org markup to help AI bots understand your videos, images, and audio as interconnected entities.\n\n2. Double Down on E-E-A-T\nShowcase Real Experience: Google now explicitly prioritizes \"Experience\". Include original data, case studies, and firsthand product reviews to prove you aren't just rehashing AI-generated text.\nBuild Author Authority: Create detailed author bios with professional credentials and links to verifiable social profiles like LinkedIn.\nCite Sources: Use clear citations for all statistical claims to boost the \"Trustworthiness\" pillar of E-E-A-T.\n\n3. Technical & Performance Foundations\nOptimize Core Web Vitals: Focus on \"Interaction to Next Paint\" (INP) alongside LCP and CLS to ensure the site feels responsive, not just fast-loading.\nMobile-First Everything: Google predominantly uses the mobile version of your site for indexing; ensuring a seamless touch-friendly experience is non-negotiable.\nStrategic Internal Linking: Use tools like AIOSEO's Link Assistant to build topic clusters, which helps search engines understand your site's depth on a specific niche.\n\n4. Content Strategy for 2025\nTarget \"Zero-Volume\" Keywords: Don't ignore terms that tools report as having 0 volume; these niche, high-intent queries often lead to the highest conversion rates.\nPrune and Refresh: Regularly audit and \"prune\" ineffective or outdated content (pre-2023) to prevent it from dragging down your overall domain authority.\nSearch Everywhere Optimization: Recognize that your audience is searching on YouTube, TikTok, and Reddit. Distribute your content across these platforms to build a resilient brand presence.\n\n5. Essential Tools for 2025\nGoogle Search Console: Use it to monitor AI Overview visibility and find \"low-hanging fruit\" keywords ranking on page two.\nSemrush or Ahrefs: Critical for tracking competitor content gaps and analyzing backlink profiles.\nPageSpeed Insights: The standard for auditing Core Web Vitals and identifying slow-loading elements.",
        "citations_found": true,
        "citations": [
            {
                "id": 1,
                "url": "https://searchengineland.com/seo-priorities-2025-453418#:~:text=What%20to%20do%20right%20now,gaps%20in%20your%20current%20strategy.",
                "title": "SEO priorities for 2025: Your guide to search success",
                "description": "Table of Contents * The evolution of search engines in 2025. * Content strategy and optimization. * Adapting to zero-click searche...",
                "section": "citations"
            },
            {
                "id": 2,
                "url": "https://www.getpassionfruit.com/blog/mastering-seo-in-2025-top-strategies-for-dominating-search-rankings#:~:text=Create%20High%2DValue%20Content%20That,compared%20to%20constant%20new%20production.",
                "title": "Top SEO Strategies for 2025 to Drive Real Growth | Passionfruit",
                "description": "Mastering SEO in 2025: Top Strategies for Dominating Search Rankings. ... The rules of SEO have fundamentally shifted. What worked...",
                "section": "citations"
            },
            {
                "id": 3,
                "url": "https://nogood.io/blog/seo-trends-2025/",
                "title": "2025 SEO Trends: 8 Things We're Seeing | NoGood",
                "description": "What You Should Do. Treat AEO as a dedicated channel within your organic strategy. Identify your top content that aligns with high...",
                "section": "citations"
            },...
        ]
    }
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/llm-scraper/google-ai-mode.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
