DataForSEO SERP APIInstall

Summary

Fetch live Google Organic search engine results page (SERP) HTML for a specified keyword and search parameters.

Inputs

• Keyword (required) — The search keyword (up to 700 characters) to query Google's organic search results. Special characters like % and + must be URL encoded as %25 and %2B respectively.
• Location (required) — Full name of the Google search location to simulate for the query (e.g., a city or country). Consult DataForSEO documentation for supported locations.
• Language (required) — Full name of the Google search language to use for the query. Consult DataForSEO documentation for supported languages.
• GPS Coordinates of a Location — Optional GPS coordinates in the format latitude,longitude,radius to specify location more precisely.
• Device — Device type to simulate the search from, either Desktop or Mobile. Defaults to Desktop.
• OS — Operating system of the device used in the query. Options vary based on the device chosen: Windows or macOS for desktop; Android or iOS for mobile.
• Search Engine Domain — Optional custom Google domain (e.g., google.co.uk) to override the domain chosen automatically based on location and language.
• Depth — Number of organic results to retrieve, between 1 and 700. Defaults to 100.
• Direct URL of the Search Query — A direct Google search URL which will be parsed to extract search parameters automatically.
• Page Crawl Limit — Limit on the number of SERP pages to crawl, between 1 and 100.
• Additional Parameters of the Search Query — Extra query parameters to customize the Google search beyond the standard options.
• Expand AI Overview? — Boolean option to expand the AI overview section in the SERP HTML output if present.

Output shape

a JSON object containing the raw HTML content of the live Google Organic SERP for the specified query parameters

Returned HTML represents the live organic Google search results page as retrieved in real-time. Pagination up to the specified depth and page crawl limits is supported. Special options to expand AI overview sections affect the HTML content returned. Errors and limits from the DataForSEO API may influence response availability.

Examples

Example 1: Retrieve the live Google organic SERP HTML for the keyword 'n8n automation' in New York (location), English language, on a desktop Windows device with default depth 100.

Set Keyword to 'n8n automation', Location to 'New York, USA', Language to 'English', Device to 'Desktop', OS to 'Windows', other fields left as defaults.

Links

• n8n community nodes installation guide