Actions30
- AI Optimization Actions
- Backlink Actions
- Business Data Actions
- Keywords Data Actions
- Labs Actions
- On Page Actions
- SERP Actions
SERP → Get Parsed SERP
AI-generatedSummary
Retrieve Google Search Engine Results Page (SERP) data parsed for a specified keyword, location, language, device, and operating system.
Inputs
- Keyword (required) — The search query keyword, up to 700 characters. Special characters are decoded; use %25 for % and %2B for + if needed.
- Location (required) — Full name of the search engine location (e.g., country or city). Refer to DataForSEO documentation for supported locations.
- Language (required) — Full name of the search engine language. Refer to DataForSEO documentation for supported languages.
- Device — Device type to emulate in the search: 'Desktop' or 'Mobile'. Defaults to 'Desktop'.
- OS — Operating system of the device: if Desktop, choose 'windows' or 'macos'; if Mobile, choose 'android' or 'ios'. Defaults to 'windows'.
- Search Engine Domain — Custom search engine domain to override the automatic selection based on location and language (e.g., google.co.uk).
- Depth — Number of search results depth to retrieve, between 1 and 700. Defaults to 100.
- Target — Target domain, subdomain, or webpage to filter results. Supports wildcards (*) for pattern matching in URLs.
Output shape
a single JSON object with parsed SERP data from Google search results
The response contains live organic search result data parsed according to specified parameters. If a 'target' is specified, results are filtered to SERP elements containing URLs matching the target pattern. The results reflect the given device and OS configuration. The operation performs a synchronous API call to DataForSEO's /serp/google/organic/live/regular endpoint.
Examples
Example 1: Retrieve parsed Google SERP data for keyword 'n8n nodes' in London, English language, desktop Windows device, default search engine domain and depth 50.
Set Keyword to 'n8n nodes', Location to 'London, England, United Kingdom', Language to 'English', Device to 'Desktop', OS to 'Windows', Depth to 50, leave Search Engine Domain and Target empty.