DataForSEO SERP APIInstall

Summary

Retrieve an advanced live Google AI Mode SERP (Search Engine Results Page) for a specified keyword with detailed customization options such as location, language, device, operating system, and browser screen parameters.

Inputs

• Keyword (required) — The search keyword to query on Google; supports up to 700 characters and requires URL encoding for percent (%) and plus (+) symbols.
• Task Priority — Execution priority for the task, either Normal (1) or High (2). Defaults to Normal.
• Location (required) — The full name of the search engine location to simulate the search results from; must be a supported location per DataForSEO documentation.
• Language (required) — The full name of the search engine language used to retrieve the SERP; must be a supported language as per DataForSEO documentation.
• GPS Coordinates of a Location — Latitude, longitude, and radius formatted as 'latitude,longitude,radius'; optionally refines location for the search.
• Device — The type of device to simulate the search from, either 'desktop' or 'mobile'; defaults to 'desktop'.
• OS — The device operating system, which must be compatible with the selected device: 'windows' or 'macos' for desktop, 'android' or 'ios' for mobile; defaults to 'windows'.
• Calculate Pixel Rankings for SERP Elements in Advanced Results? — If true, adds pixel ranking coordinates for SERP elements in the response; this enhances positional data detailing.
• Browser Screen Width — Width of the simulated browser screen in pixels; affects rendering context.
• Browser Screen Height — Height of the simulated browser screen in pixels; affects rendering context.
• Browser Screen Resolution Ratio — Device pixel ratio for the browser simulation, ranging from 1 to 3; influences rendering accuracy.

Output shape

a detailed object representing the live Google AI Mode SERP data for the specified keyword and parameters, including organic results and possibly pixel ranking information if requested.

The output contains advanced SERP details fetched live from Google using AI Mode, supporting customization by location, language, device type, OS, and browser parameters. The response includes the SERP structure as JSON, suitable for further workflow processing. Task priority affects execution speed. Consult DataForSEO documentation for valid values for location and language inputs.

Links

• n8n community nodes installation guide