Google AI Mode

This document provides information about the API and the available POST parameters.

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

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

Field Descriptions

Field

Description

Parameter Type

prompt

Main prompt sent to ChatGPT. Max length: 4096 chars.

Required

country

Target geographic region for contextual responses.

Optional

engine

The chatbot engine to use. Currently "chatgpt" and "google_ai_mode" is supported.

Required(default: chatgpt)

Example Usage

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"
  }'

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())

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));

Response Format

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

Example JSON Response

{
    "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"
            },...
        ]
    }
}

PreviousExample Requests NextFeatures

Last updated 1 day ago

{ "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" },... ] } }

hashtagAPI Setup

hashtagEndpoint

hashtagAuthentication

hashtagRequest Body Schema

hashtagField Descriptions

hashtagExample Usage

hashtagResponse Format

hashtagExample JSON Response