Actions29
- 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 fetching keywords related to a given set of input keywords. It is useful for SEO professionals, digital marketers, and content creators who want to expand their keyword research by discovering additional relevant keywords based on seed keywords.
Typical use cases include:
- Generating keyword ideas for SEO campaigns.
- Finding related keywords to optimize website content.
- Analyzing keyword opportunities in specific locations and languages.
For example, if you provide a list of keywords like "running shoes" and "fitness gear," the node will return related keywords that users also search for, helping you broaden your keyword targeting strategy.
Properties
| Name | Meaning |
|---|---|
| Keywords | A collection of up to 20 keywords (each up to 80 characters) for which related keywords will be fetched. The keywords are converted to lowercase automatically. |
| Location | Full name of the location to target the keyword data for (e.g., "United States"). Supported locations can be found in the DataForSEO documentation. |
| Language | Full name of the language to target the keyword data for (e.g., "English"). Supported languages are listed in the DataForSEO documentation. |
| Include Google Search Partners? | Boolean flag indicating whether to include results from Google's owned, operated, and syndicated partner sites. Default is false, meaning only Google search sites are included. |
| 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 the data. Minimum allowed is 4 years before the current date. If not specified, defaults to the past 12 months. |
| Date To | Optional end date for the time range of the data. Cannot be later than the previous month since current month data is unavailable. Defaults to yesterday's date if not specified. |
| Sort By | Option to sort the returned keywords by one of the following criteria: Relevance, Search Volume, Competition Index, Low Top Of Page Bid, or High Top Of Page Bid. Default is no sorting (empty). |
Output
The node outputs an array of JSON objects where each object represents keyword data related to the input keywords. The structure typically includes fields such as:
- Related keyword text.
- Search volume metrics.
- Competition index.
- Bid prices for ads (low and high top of page bids).
- Relevance score.
If binary data were involved (not indicated here), it would represent files or media related to the keywords, 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 uses the DataForSEO v3 API endpoint
https://api.dataforseo.com/v3. - Proper configuration of the API credentials within n8n is necessary.
- Internet access to reach the DataForSEO API.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing more than 20 keywords or keywords longer than 80 characters may result in validation errors.
- Incorrect location or language names not matching DataForSEO supported values will lead to errors or empty results.
- Date ranges outside allowed limits (e.g., future dates or less than 4 years ago) may cause API rejections.
Error messages:
- Authentication failures: Check API key validity and credential setup.
- Validation errors about keywords count or length: Ensure inputs meet the specified limits.
- Unsupported location/language errors: Verify against DataForSEO documentation for correct names.
- Rate limiting or quota exceeded: Consider upgrading your DataForSEO plan or reducing request frequency.