Actions29
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The node integrates with the DataForSEO API to retrieve Google Search Engine Results Page (SERP) data using an AI-powered mode. It allows users to perform advanced SERP queries that simulate real user search behavior on Google, including detailed location, language, device, and operating system settings. This is particularly useful for SEO professionals, digital marketers, and analysts who want to gather precise search results tailored to specific geographic and device contexts.
Practical examples include:
- Monitoring keyword rankings in different countries or cities.
- Analyzing how search results vary between desktop and mobile devices.
- Extracting rich SERP features and AI-enhanced insights for competitive analysis.
- Testing how changes in browser screen size or resolution affect SERP layout and ranking.
Properties
| Name | Meaning |
|---|---|
| Keyword | The search query keyword (up to 700 characters). Special URL encoding rules apply: %## sequences are decoded; % must be encoded as %25; + must be encoded as %2B. |
| Location | Full name of the search engine location to simulate (e.g., city or country). Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the search engine language to use for the query. Supported languages are listed in the DataForSEO documentation. |
| Device | The type of device to simulate for the search: either "Desktop" or "Mobile". |
| OS | Operating system of the simulated device. For Desktop: "Windows" or "macOS". For Mobile: "Android" or "iOS". |
| Calculate Pixel Rankings for SERP Elements? | Boolean flag indicating whether to calculate pixel-based rankings (rectangles) for SERP elements, which can help visualize element positions on the page. Defaults to false. |
| Browser Screen Width | Optional numeric value specifying the width of the browser screen in pixels. |
| Browser Screen Height | Optional numeric value specifying the height of the browser screen in pixels. |
| Browser Screen Resolution Ratio | Optional numeric value specifying the resolution ratio of the browser screen. |
Output
The node outputs a JSON array where each item corresponds to the parsed SERP data for the given input keyword and parameters. The JSON structure typically includes:
- Detailed search result entries with titles, URLs, snippets, and metadata.
- Rich SERP features such as featured snippets, knowledge panels, ads, local packs, etc.
- AI-enhanced annotations or interpretations of the SERP content.
- If pixel ranking calculation is enabled, positional data describing the location and size of SERP elements on the rendered page.
The output does not include binary data.
Dependencies
- Requires an active DataForSEO API account with valid API credentials (API key/token).
- The node uses HTTP POST requests to the DataForSEO v3 API endpoint.
- Proper configuration of the API credential in n8n is necessary.
- Internet access from the n8n instance to reach the DataForSEO API.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Incorrect or unsupported location or language names may lead to API errors or empty results.
- Exceeding the maximum keyword length or improper encoding of special characters can cause request failures.
- Specifying incompatible device and OS combinations (e.g., mobile device with Windows OS) may result in errors.
Error messages:
- Authentication errors: Verify API credentials and permissions.
- Validation errors: Check that all required fields (keyword, location, language) are correctly filled and supported.
- Rate limiting or quota exceeded: Ensure your DataForSEO plan supports the volume of requests.
- Network errors: Confirm network connectivity and API endpoint accessibility.