Actions29
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Keyword Ideas" operation in the Labs resource of this node fetches keyword idea suggestions based on input keywords. It is useful for SEO specialists, digital marketers, and content creators who want to discover new relevant keywords to target in their campaigns or content strategies. By providing seed keywords, location, and language, users can obtain a list of related keyword ideas that help expand their keyword research and improve search engine visibility.
Practical examples include:
- Generating a list of potential keywords to optimize a website's content.
- Finding alternative keywords for paid search campaigns.
- Exploring niche topics related to a core keyword for blog post ideas.
Properties
| Name | Meaning |
|---|---|
| Keywords | A collection of seed keywords (minimum 3 characters each) to base the keyword ideas on. Up to 200 keywords can be specified. The keywords will be converted to lowercase. |
| Location | Full name of the geographic location to tailor keyword ideas to a specific market or region. Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the language to filter keyword ideas by language. Supported languages are listed in the DataForSEO documentation. |
| Search Mode | Boolean flag to choose between phrase-match (true) or broad-match (false) search algorithms for generating keyword ideas. |
| Ignore Synonyms | Boolean flag to exclude highly similar keywords, returning only core keywords if set to true. |
| Include SERP Info? | Boolean flag to include additional search engine results page (SERP) information with the keyword ideas. |
| Include clickstream-based metrics in the result? | Boolean flag to include clickstream data metrics such as user behavior statistics in the results. |
| Limit | Number specifying the maximum number of keyword ideas to return (up to 1000). Defaults to 100. |
| Offset | Number specifying the offset for pagination of results. Defaults to 0. |
| Filters | String containing filters to narrow down the keyword ideas based on supported fields (see DataForSEO documentation). |
| Sort | Up to three sorting rules to order the results. Each rule includes a field name and direction (ascending or descending). Supported fields are documented by DataForSEO. |
Output
The output is a JSON array where each element represents a keyword idea with associated metadata. Typical fields may include the suggested keyword text, search volume, competition metrics, and optionally SERP info or clickstream data if requested.
If enabled, the node can also provide detailed SERP information related to each keyword idea, such as top-ranking URLs or snippet data.
No binary data output is indicated for this operation.
Dependencies
- Requires an active API key credential for the DataForSEO service.
- The node makes POST requests to the DataForSEO API endpoint at
https://api.dataforseo.com/v3. - Users must configure the API authentication credentials within n8n before using this node.
- Supported locations and languages must be chosen according to DataForSEO's documented lists.
Troubleshooting
Common issues:
- Invalid or missing API credentials will cause authentication errors.
- Specifying unsupported location or language names will result in API errors.
- Providing keywords shorter than 3 characters or exceeding the maximum count (200) may cause validation failures.
- Using invalid filter or sort field names not recognized by the API will lead to request errors.
Error messages:
- Authentication errors: Check that the API key credential is correctly configured and valid.
- Validation errors about keywords or parameters: Ensure all required fields are provided and conform to expected formats.
- Rate limiting or quota exceeded: Verify your DataForSEO account limits and usage.