Actions29
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Organic Traffic Stats" operation in the Labs resource of this node fetches organic traffic statistics for specified domains or subdomains. It is useful for SEO professionals, digital marketers, and website owners who want to analyze the volume and trends of organic search traffic their websites receive from specific locations and languages.
Typical use cases include:
- Monitoring organic traffic performance over time.
- Comparing traffic stats across multiple domains or subdomains.
- Analyzing traffic data segmented by location and language to tailor marketing strategies.
- Integrating organic traffic insights into automated reporting workflows.
For example, a user might input a list of target domains without protocol or "www" prefixes, specify a geographic location like "United States," and a language such as "English," then retrieve detailed organic traffic metrics for those targets.
Properties
| Name | Meaning |
|---|---|
| Target Domains or Subdomains (targets) | One or more domains or subdomains to query for organic traffic stats. Domains should be specified without https:// or www. prefixes. Multiple targets can be added. |
| Location (location_name_required) | The full name of the geographic location for which to retrieve traffic data. This must match supported locations as defined in the DataForSEO documentation. Example: "United States". |
| Language (language_name_required) | The full name of the language for which to retrieve traffic data. Must correspond to supported languages listed in the DataForSEO documentation. Example: "English". |
| Item Types (item_types) | Specifies which types of search results to include in the response. Options are: • Organic • Paid • Featured Snippet • Local Pack Multiple selections allowed. Defaults to empty (no filter). |
Output
The node outputs an array of JSON objects, each representing the organic traffic statistics for one of the specified target domains or subdomains. The exact structure depends on the API response but typically includes fields such as:
- Domain or subdomain queried.
- Traffic metrics (e.g., number of visits, clicks).
- Date or time period of the statistics.
- Breakdown by item types if specified (organic, paid, etc.).
- Additional metadata related to the traffic source.
No binary data output is produced by this operation.
Dependencies
- Requires an active API key credential for the DataForSEO service configured in n8n.
- Internet access to call the DataForSEO v3 API endpoint at
https://api.dataforseo.com/v3. - Proper configuration of the node with valid inputs for targets, location, and language according to DataForSEO's supported values.
Troubleshooting
Common issues:
- Invalid domain format: Ensure domains do not include
https://orwww.prefixes. - Unsupported location or language: Verify that the location and language names exactly match those supported by DataForSEO.
- Empty or missing required parameters: Targets, location, and language are mandatory; missing these will cause errors.
- API authentication failures: Check that the API key credential is correctly set up and has sufficient permissions.
- Invalid domain format: Ensure domains do not include
Error messages:
"Something went wrong": Generic error indicating the requested resource-operation combination was not found or misconfigured.- Network or timeout errors: May indicate connectivity issues or API rate limits.
To resolve errors, verify all input parameters, ensure credentials are valid, and consult the DataForSEO API documentation for correct parameter values.