Actions28
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
This node integrates with the DataForSEO API to retrieve keyword-related data, specifically for the "Get Keywords for Keywords" operation under the "Keywords Data" resource. It allows users to input a list of keywords and obtain detailed keyword information such as search volume, competition index, bid prices, and relevance metrics.
Common scenarios where this node is beneficial include:
- SEO professionals researching keyword opportunities.
- Digital marketers analyzing keyword competitiveness and trends.
- Content creators optimizing content strategy based on keyword data.
Practical example: A user inputs up to 20 keywords along with location and language parameters to get insights about those keywords' performance in a specific market, helping them decide which keywords to target in their campaigns.
Properties
| Name | Meaning |
|---|---|
| Keywords | Up to 20 keywords (each max 80 characters) to analyze. Keywords are converted to lowercase automatically. |
| Location | Full name of the location to target (e.g., "United States"). Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the language to target (e.g., "English"). Supported languages are listed in the DataForSEO documentation. |
| Include Google Search Partners? | Boolean flag indicating whether to include results from Google search partners (owned, operated, syndicated networks) besides Google search sites. Default is false. |
| Include keywords associated with adult content? | Boolean flag to include adult keywords in the response if set to true. Default is false. |
| Date From | Optional start date for the time range of data. Minimum allowed is 4 years before the current date. Defaults to past 12 months if not specified. |
| Date To | Optional end date for the time range of data. Cannot be later than the previous month (Google Ads does not provide current month data). Defaults to yesterday's date if not specified. |
| Sort By | Option to sort the results by one of the following criteria: Relevance, Search Volume, Competition Index, Low Top Of Page Bid, High Top Of Page Bid, or leave empty for no sorting. |
Output
The node outputs an array of JSON objects, each representing keyword data corresponding to the input keywords. The output typically includes fields such as:
- Keyword text (lowercased)
- Search volume statistics
- Competition index
- Bid price ranges (low and high top of page bids)
- Relevance score
- Other keyword metrics provided by the DataForSEO API
If binary data were involved, it would be summarized here, but this node focuses on JSON keyword data only.
Dependencies
- Requires an active DataForSEO API account with valid API credentials (API key/token).
- The node expects these credentials to be configured in n8n via a generic API authentication method.
- Internet access to reach
https://api.dataforseo.com/v3.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Specifying unsupported location or language names may result in API errors or empty responses.
- Exceeding the maximum number of keywords (20) or keyword length (80 characters) may cause validation errors.
- Date range outside allowed limits (more than 4 years ago or future dates) can lead to errors or no data returned.
Error messages:
- "Something went wrong": Generic error indicating failure in execution; check API credentials and parameter correctness.
- API-specific errors related to invalid parameters will usually indicate which field is problematic; verify against DataForSEO documentation.
Resolution tips:
- Double-check all input parameters for correctness and adherence to documented constraints.
- Ensure API credentials are correctly set up in n8n.
- Review DataForSEO documentation for supported locations and languages.
- Use smaller batches of keywords if hitting limits.