DataForSEO SERP APIInstall

Summary

Retrieve Google organic search results (regular SERP) for a specified keyword, location, language, and device settings using the DataForSEO SERP API.

Inputs

• Keyword (required) — The search query keyword, up to 700 characters, where certain URL-encoded characters like % and + need to be encoded as %25 and %2B respectively.
• Task Priority — Execution priority of the task, either normal or high priority.
• Location (required) — Full name of the search engine location to target for the search results, according to DataForSEO's supported locations.
• Language (required) — Full name of the search engine language to use, according to DataForSEO's supported languages.
• GPS Coordinates of a Location — Optional GPS coordinates with radius in latitude,longitude,radius format to refine the location context.
• Device — Device type to simulate (desktop or mobile).
• OS — Operating system of the device (windows, macos for desktop; android, ios for mobile).
• Search Engine Domain — Optional override of the search engine domain, e.g., google.co.uk or google.com.au; otherwise automatically chosen based on location and language.
• Depth — Number of search results depth to retrieve, value between 1 and 700, defaulting to 100.
• Direct URL of the Search Query — Optional direct Google search URL to fetch results from, parsing query parameters automatically.
• Display Related Results? — Boolean to include related results snippets within their parent organic results.
• Page Crawl Limit — Optional limit on the number of crawl pages for extended scraping scenarios (1-100).
• Additional Parameters of the Search Query — Extra search query parameters as a string, appended to the query for advanced use cases.
• Calculate Pixel Rankings for SERP Elements in Advanced Results? — Boolean to enable calculation of pixel coordinates for SERP elements in advanced results (false by default).
• Browser Screen Width — Optional browser viewport width used in rendering the SERP results for pixel-based features.
• Browser Screen Height — Optional browser viewport height used in rendering the SERP results for pixel-based features.
• Browser Screen Resolution Ratio — Optional device pixel ratio (1 to 3), determining screen resolution scaling.
• Clicks on the Corresponding Element — Optional numeric depth (1 to 4) for People Also Ask clicks to simulate in results expansion.
• Load Asynchronous AI Overview — Boolean indicating whether to load AI overview elements that are loaded asynchronously (default false).
• Expand AI Overview? — Boolean to expand AI overview sections in results (false by default).
• Remove Specific Parameters From URLs — Collection of URL query parameters to remove from URLs in the returned results, up to 10 parameters.

Output shape

a JSON object representing Google's organic search results for the specified query, location, and device, including an array of organic result entries and optional related result snippets.

The structure corresponds to the DataForSEO Google Organic SERP Regular API response format. Results depth and included fields depend on input parameters. Related results and AI overview data are optional and controlled by flags. Network or API errors will result in node execution failure.

Links

• n8n community nodes installation guide