Actions28
- 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 optimization efforts.
Practical examples include:
- Generating a list of potential keywords to target for a blog post or website page.
- Exploring keyword variations and synonyms to optimize PPC campaigns.
- Analyzing keyword opportunities in specific geographic locations and languages.
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 for. Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the language to tailor keyword ideas for. Supported languages are listed in the DataForSEO documentation. |
| Search Mode | Boolean flag indicating whether to use phrase-match search algorithm (true) or broad-match search algorithm (false) for generating keyword ideas. |
| Ignore Synonyms | Boolean flag to exclude highly similar keywords (synonyms). If true, only core keywords are returned, excluding close variants. |
| 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 (user behavior data) 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 filter expressions to narrow down the keyword ideas based on supported fields (see DataForSEO docs). |
| Sort | Up to three sorting rules to order the results by specified fields in ascending or descending order. Each rule includes a field name and direction (asc or desc). |
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.
- Metrics such as search volume, competition, CPC, or difficulty scores.
- Optional SERP information if requested.
- Optional clickstream-based metrics if included.
If binary data were output, it would represent any non-JSON data attached to the response, but this operation primarily returns structured JSON keyword data.
Dependencies
- Requires an active API key credential for the DataForSEO service.
- Network access to the DataForSEO API endpoint at
https://api.dataforseo.com/v3. - Proper configuration of the node with the API key credential.
- Supported locations and languages must be valid as per DataForSEO documentation.
Troubleshooting
- Invalid or missing API credentials: Ensure the API key credential is correctly configured and has sufficient permissions.
- Unsupported location or language: Verify that the location and language names match those supported by DataForSEO.
- Exceeding keyword limits: Do not specify more than 200 keywords; otherwise, the request may fail.
- Invalid filters or sort fields: Use only supported filter and sort field names as documented.
- Network errors or timeouts: Check network connectivity and API availability.
- Error messages like "Something went wrong": This generic error indicates an unexpected failure; check the node's execution logs for detailed error messages from the API.