DataForSEO SERP APIInstall

Summary

Retrieve advanced live Google organic search engine results pages (SERP) data for a specified keyword, location, and language with detailed customizable parameters.

Inputs

• Keyword (required) — Search query up to 700 characters, supports encoding rules for percent and plus symbols.
• Location (required) — Full name of the search engine location to use for the query; must be a supported location.
• Language (required) — Full name of the search engine language to use for the query; must be a supported language.
• GPS Coordinates of a Location — Optional latitude,longitude,radius string to refine location targeting.
• Device — Device type to simulate, either Desktop or Mobile (default is Desktop).
• OS — Operating system of the device, chosen from Windows, macOS, Android, or iOS depending on device type.
• Search Engine Domain — Override default search engine domain for the query.
• Depth — Number of search results depth, between 1 and 700 (default 100).
• Target — Optional domain, subdomain, or URL pattern to filter SERP results.
• Direct URL of the Search Query — Specify a direct URL query to parse relevant fields from it.
• Display Related Results? — Boolean to include related results snippets within parent organic results (default true).
• Page Crawl Limit — Maximum number of pages to crawl for the query results, between 1 and 100.
• Additional Parameters of the Search Query — Extra parameters to include in the search request.
• Calculate Pixel Rankings for SERP Elements in Advanced Results? — Boolean to enable pixel position data for SERP elements (default false).
• Browser Screen Width — Optional browser screen width in pixels for query rendering context.
• Browser Screen Height — Optional browser screen height in pixels for query rendering context.
• Browser Screen Resolution Ratio — Screen resolution ratio value from 1 to 3 for rendering context.
• Clicks on the Corresponding Element — Number from 1 to 4 indicating depth of people-also-ask clicks to simulate.
• Load Asynchronous AI Overview — Boolean to include AI overview items loaded asynchronously in results (default false).
• Remove Specific Parameters From URLs — List of up to 10 URL parameters to remove from result URLs.

Output shape

a JSON object representing advanced live Google organic SERP data including detailed search results, related results snippets, pixel position data (optional), and AI overview items (optional) depending on parameters set.

The response includes rich and advanced search result details. Pagination depends on 'depth' and 'max_crawl_pages' inputs. Related results and pixel data are optional. Errors or rate limits are represented in error structures.

Links

• n8n community nodes installation guide