DataForSEO SERP APIInstall

Summary

Retrieve the raw HTML of Google's organic search engine results page (SERP) for a specified keyword and search criteria.

Inputs

• keyword (required) — The search query keyword, up to 700 characters. Percent-encoded characters like % and + should be specified as %25 and %2B respectively.
• location_name (required) — Full name of the search engine location to simulate the search from, e.g., 'United States'. Must match supported locations in DataForSEO documentation.
• language_name (required) — Full name of the search engine language for the query, e.g., 'English'. Must match supported languages in DataForSEO documentation.
• priority — Task execution priority, default is normal (1). Can be set to high (2) for faster processing.
• location_coordinate — GPS coordinates with radius in "latitude,longitude,radius" format to specify search location, e.g., "53.476225,-2.243572,200".
• device — The device type to emulate: desktop or mobile. Default is desktop.
• os — Operating system of the device. For desktop: 'windows' or 'macos'. For mobile: 'android' or 'ios'. Default is windows.
• se_domain — Custom search engine domain for the query (e.g., google.co.uk). If omitted, automatically selected based on location and language.
• depth — Number of search result pages to retrieve, from 1 to 700. Default is 100.
• url — Direct URL of the Google search results page to parse instead of parameters.
• group_organic_results — When true (default), related results are returned nested within their parent organic results.
• max_crawl_pages — Limit on the number of pages to crawl, from 1 to 100.
• search_param — Additional raw parameters for the search query.
• calculate_rectangles — If true, calculates pixel rankings and rectangles of SERP elements in advanced results.
• browser_screen_width — Emulated browser screen width in pixels.
• browser_screen_height — Emulated browser screen height in pixels.
• browser_screen_resolution_ratio — Emulated screen resolution ratio, between 1 and 3.
• people_also_ask_click_depth — Depth for simulating clicks on 'People also ask' elements, from 1 to 4.
• load_async_ai_overview — If true, loads AI overview items even if they are loaded asynchronously.
• expand_ai_overview — If true, expands AI overview snippets.
• remove_from_url — List of up to 10 parameters to remove from URLs in the result to clean tracking or unwanted query parameters.

Output shape

a JSON object containing the raw HTML content of the Google Organic SERP corresponding to the specified query and parameters.

The response provides the full HTML of the SERP as returned by Google's search, not parsed structured data. The request can simulate various devices, locations, languages, and other search parameters. Pagination is controlled by 'depth' and 'max_crawl_pages'. Some optional parameters affect the result detail, such as grouping related results and removing URL parameters.

Links

• n8n community nodes installation guide