Actions28
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Keyword Difficulty" operation in the Labs resource of this node allows users to obtain difficulty metrics for a list of keywords. This is useful for SEO professionals and digital marketers who want to evaluate how challenging it would be to rank for specific keywords in search engines. By understanding keyword difficulty, users can prioritize keywords that offer better opportunities for organic traffic growth.
Typical use cases include:
- Assessing the competitiveness of target keywords before creating content.
- Comparing multiple keywords to select the best ones for SEO campaigns.
- Integrating keyword difficulty data into automated SEO workflows.
For example, a user might input a list of 10 keywords related to their niche along with the target location and language, then receive difficulty scores indicating which keywords are easier or harder to rank for in that market.
Properties
| Name | Meaning |
|---|---|
| Target Keywords | A collection of keywords (up to 1000) for which the difficulty will be assessed. Each keyword must be at least 3 characters long and will be converted to lowercase. |
| Location | The full name of the geographic location where the keyword difficulty should be evaluated. Supported locations are documented externally. |
| Language | The full name of the language relevant to the keyword difficulty assessment. Supported languages are documented externally. |
Output
The output is a JSON array where each element corresponds to the keyword difficulty data for one or more input keywords. Each item typically includes:
- The keyword(s) analyzed.
- Difficulty metrics such as a numeric score representing how hard it is to rank for the keyword.
- Possibly additional metadata related to the keyword's search environment in the specified location and language.
No binary data output is expected from this operation.
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 ensure that the location and language values correspond to those supported by DataForSEO, as per their documentation.
Troubleshooting
- Invalid or missing keywords: Ensure that each keyword is at least 3 characters long and properly formatted. Empty or too short keywords may cause errors.
- Unsupported location or language: Using unsupported location or language names will likely result in API errors. Verify these values against the official DataForSEO supported locations and languages list.
- API authentication errors: If the API key credential is invalid or missing, the node will fail to authenticate. Confirm that the correct API key is configured in n8n credentials.
- Request limits exceeded: The API may limit the number of keywords per request (max 1000). Sending more than allowed will cause errors.
- Network or connectivity issues: Ensure that the n8n instance has internet access and can reach the DataForSEO API endpoint.
Common error messages generally indicate either parameter validation failures or authentication problems. Reviewing the error details and adjusting inputs accordingly usually resolves these issues.