Actions29
- 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 scores for a list of target keywords. This metric helps evaluate how challenging it would be to rank organically for each keyword in search engines. The node is useful for SEO specialists, digital marketers, and content creators who want to prioritize keywords based on competition level.
Typical use cases include:
- Assessing which keywords to target in SEO campaigns.
- Comparing keyword difficulty across multiple keywords before content planning.
- Integrating keyword difficulty data into automated SEO workflows.
For example, a user can input up to 1000 keywords along with a specific location and language to receive difficulty scores that reflect local search competition.
Properties
| Name | Meaning |
|---|---|
| Target Keywords | A collection of keywords (minimum 3 characters each) for which the difficulty score will be retrieved. Up to 1000 keywords can be specified. Keywords are converted to lowercase automatically. |
| Location | The full name of the geographic location to tailor the keyword difficulty results. Supported locations are listed in the DataForSEO documentation. |
| Language | The full name of the language to specify the linguistic context for the keyword difficulty analysis. Supported languages are listed in the DataForSEO documentation. |
Output
The output is a JSON array where each element corresponds to one of the input keywords. Each element contains detailed information about the keyword difficulty, including but not limited to:
- The keyword itself.
- The difficulty score indicating how hard it is to rank for that keyword.
- Additional metadata related to search volume, competition, or other SEO metrics as provided by the API.
If the node supports binary data output (not indicated here), it would typically represent downloadable reports or files related to the keyword difficulty analysis.
Dependencies
- Requires an active API key credential for the DataForSEO service.
- The node sends 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.
- The node depends on the DataForSEO Labs API supporting the "get-keyword-difficulty" operation.
Troubleshooting
Common issues:
- Providing keywords shorter than 3 characters may cause errors or be ignored.
- Exceeding the maximum number of keywords (1000) could result in request failures.
- Incorrect or unsupported location or language names may lead to API errors.
- Missing or invalid API credentials will prevent successful requests.
Error messages:
- "Something went wrong": Generic error if the requested resource-operation combination is not found or improperly configured.
- API response errors related to authentication or quota limits should be checked in the API key settings.
Resolutions:
- Verify all keywords meet length requirements.
- Confirm location and language names against the official supported lists.
- Ensure the API key credential is correctly set up and has sufficient permissions.
- Check network connectivity and API endpoint accessibility.