DataForSEO SERP APIInstall

Summary

Retrieve live Google search engine results page (SERP) HTML generated by Google's AI mode for a specified keyword and search context.

Inputs

• Keyword (required) — The search keyword (up to 700 characters) to query the Google AI Mode SERP for; supports URL-encoded characters (% symbol and + symbol must be encoded if literal).
• Location (required) — Full name of the search engine location to simulate the search from, per supported DataForSEO locations.
• Language (required) — Full name of the search engine language to use for the AI Mode SERP, as per supported DataForSEO languages.
• GPS Coordinates of a Location — String specifying latitude, longitude, and radius to refine location in 'lat,long,radius' format.
• Device — Device type to simulate the search on; either 'desktop' or 'mobile', defaults to desktop.
• OS — Operating system of the simulated device; for desktop choose 'windows' or 'macos', for mobile choose 'android' or 'ios', defaults to windows.
• Search Engine Domain — Custom Google search engine domain to use instead of auto-selected based on location and language (e.g., google.co.uk).
• Depth — Maximum number of results to fetch, with a default of 100 and a max of 700.
• Direct URL of the Search Query — Optional direct URL of a Google search query to extract and process.
• Page Crawl Limit — Limits the number of result pages to crawl; values range from 1 to 100.
• Additional Parameters of the Search Query — Extra URL parameters to add to the search query for advanced customization.
• Load Asynchronous AI Overview — Set true to include AI overview items that load asynchronously in the SERP.
• Expand AI Overview? — Set true to expand AI overview details in the returned HTML output.

Output shape

a single record containing the raw HTML content of the live Google AI Mode SERP for the specified parameters.

The returned HTML is the live AI-powered SERP snapshot reflecting the search configuration. Optional parameters refine location, device, OS, and result depth. Special handling for asynchronous AI overview loading and expansion is supported. The node does not parse or structure the HTML beyond retrieval.

Examples

Example 1: Fetch the live AI Mode SERP HTML for keyword 'n8n workflow' in New York, English, mobile Android, using default Google domain.

Set keyword to 'n8n workflow', location_name to 'New York', language_name_ai to 'English', device to 'mobile', os to 'android'.

Links

• n8n community nodes installation guide