Actions29
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Keyword Suggestions" operation in the Labs resource of this node fetches keyword suggestions based on a given seed keyword. It is useful for SEO specialists, digital marketers, and content creators who want to discover related keywords to optimize their content or advertising campaigns. By providing a keyword along with location and language parameters, users can obtain relevant keyword ideas tailored to specific markets.
Practical examples include:
- Expanding a list of target keywords for a blog post or website.
- Finding new keyword opportunities for paid search campaigns.
- Analyzing keyword trends in different geographic locations or languages.
Properties
| Name | Meaning |
|---|---|
| Keyword | The main keyword string for which suggestions are requested. |
| Location | Full name of the location to tailor keyword suggestions geographically. Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the language to tailor keyword suggestions linguistically. Supported languages are listed in the DataForSEO documentation. |
| Ignore Synonyms | Boolean flag to exclude highly similar keywords (synonyms). If true, only core distinct keywords will be returned. |
| Include SERP Info? | Boolean flag indicating whether to include Search Engine Results Page (SERP) information alongside keyword suggestions. |
| Limit (up to 1000) | Maximum number of keyword suggestions to return. Must be between 1 and 1000. Defaults to 100. |
| Offset | Number of keyword suggestions to skip before starting to collect results. Useful for pagination. |
| Sort | Up to three sorting rules to order the keyword suggestions by metrics such as search volume, cost per click, top of page bid, or keyword difficulty. Options include ascending or descending order for each metric. |
| Filters | String containing filter expressions to narrow down keyword suggestions based on supported fields. Refer to DataForSEO documentation for syntax and available filters. |
Output
The output is a JSON array where each element represents a keyword suggestion object. Each object typically contains detailed information about the suggested keyword, including but not limited to:
- The suggested keyword text.
- Metrics such as search volume, cost per click (CPC), top of page bid values.
- Keyword difficulty score.
- Optionally, SERP-related data if requested.
This structured data allows further processing or direct use in workflows for SEO analysis, reporting, or campaign management.
The node does not output binary data.
Dependencies
- Requires an active API key credential for the DataForSEO service.
- The node makes HTTP POST requests to the DataForSEO API endpoint at
https://api.dataforseo.com/v3. - Users must configure the API key credential within n8n to authenticate requests.
- Proper configuration of location and language names according to DataForSEO's supported values is necessary.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication errors.
- Providing unsupported or misspelled location or language names may result in API errors or empty results.
- Exceeding the limit of 1000 for the "Limit" property will cause validation errors.
- Incorrect filter syntax can lead to request failures.
Error Messages:
- Authentication errors usually indicate invalid or missing API keys; verify credential setup.
- Validation errors on input parameters suggest checking the spelling and format of location, language, and filters.
- Rate limiting or quota exceeded errors require checking the DataForSEO account limits.
Resolution Tips:
- Consult the DataForSEO documentation for valid location and language names.
- Use the provided links in property hints to verify supported values.
- Ensure the API key credential is correctly configured and has sufficient permissions.
- Validate filter strings against the official filter syntax.