Google AI Mode Scraper API (Node.js)

Query Google AI Mode from Node and get back the generated answer as JSON, no browser and no HTML parsing involved. This package wraps ScrapingBee's dedicated Google Search API endpoint, which exposes AI Mode directly through a search_type flag instead of making you render Google's interactive search UI yourself.

Install

npm install google-ai-mode-scraper-api

Node 14 or newer. axios comes along as a dependency.

Usage

const { GoogleAiModeScraper } = require('google-ai-mode-scraper-api');

const scraper = new GoogleAiModeScraper({ apiKey: 'YOUR_SCRAPINGBEE_API_KEY' });

(async () => {
  const result = await scraper.search('best noise cancelling headphones under $200');
  console.log(result.ai_overviews);
})();

Sign up at ScrapingBee for 1,000 free credits, no card required.

Options

search(query, options) takes the prompt first and an options object second.

| Option | Default | What it does | |---|---|---| | countryCode | 'us' | ISO 3166-1 | | language | 'en' | | | device | 'desktop' | 'desktop' or 'mobile' | | lightRequest | true | false renders the fuller page, at a higher credit cost |

query is capped at 400 characters, the same limit Google puts on the AI Mode input box. Passing a longer string throws before any request goes out.

What comes back

{
  ai_overviews: { /* the generated answer and its citations */ },
  organic_results: [ /* pages ranking alongside the AI Mode answer */ ],
  related_queries: [ /* Google's suggested follow-up prompts */ ],
  related_searches: [],
  questions: [],
  meta_data: {}
}

When to turn lightRequest off

The default lightRequest: true covers most AI Mode prompts at 10 credits. If a response is coming back thin, set lightRequest: false for the fuller render:

const result = await scraper.search('compare the top 3 budget 4K monitors', {
  lightRequest: false,
});

That request costs 15 credits instead of 10.

Credits

lightRequest: true costs 10 ScrapingBee credits per request; lightRequest: false costs 15. This endpoint bundles proxy rotation and rendering into that flat price, so there's no separate renderJs or premiumProxy flag to manage. Full table on ScrapingBee pricing.

Notes

An independent, community-built client on the public ScrapingBee API, not affiliated with Google. It queries Google's publicly accessible AI Mode responses only. Background on the underlying endpoint is in ScrapingBee's Google API documentation.

License

MIT