Actions28
- Backlink Actions
- SERP Actions
- Business Data Actions
- On Page Actions
- Keywords Data Actions
- Labs Actions
Overview
The "Get Ranked Keywords" operation in the Labs resource of this node retrieves a list of keywords for which a specified domain ranks in search engine results. It provides detailed ranking data including keyword metrics, position on SERP (Search Engine Results Page), and other relevant SEO statistics.
This operation is beneficial for SEO professionals, digital marketers, and website owners who want to analyze their domain's keyword rankings, understand competitive positioning, and optimize content strategy based on actual search performance.
Practical examples:
- Tracking how a website ranks for various keywords in a specific location and language.
- Identifying high-volume or high-CPC keywords where the domain appears.
- Filtering ranked keywords by type of search result (organic, paid, featured snippet, local pack).
- Sorting keywords by search volume, cost per click, or ranking position to prioritize SEO efforts.
Properties
| Name | Meaning |
|---|---|
| Target Domain | The domain to analyze, specified without https:// or www. prefix. Example: example.com. |
| Location | Full name of the geographic location for the search results. Must be a supported location as per DataForSEO documentation. |
| Language | Full name of the language for the search results. Must be a supported language as per DataForSEO documentation. |
| Ignore Synonyms | Boolean flag to exclude highly similar keywords from the results, returning only core keywords if set to true. |
| Limit | Maximum number of keywords to return, up to 1000. Defaults to 100. |
| Offset | Number of keywords to skip before starting to collect results, useful for pagination. Defaults to 0. |
| Item Types | Types of search results to include in the response. Options are: Organic, Paid, Featured Snippet, Local Pack. Multiple can be selected. |
| Sort | Up to three sorting rules to order the results by various metrics such as search volume, cost per click, top of page bid, keyword difficulty, rank position, or estimated traffic value (ETV). Each rule specifies field and direction (ascending/descending). |
| Filters | String representing filters to apply on the query, following DataForSEO's filter syntax. Allows narrowing down results based on supported fields. |
Output
The output is a JSON array where each item represents a ranked keyword entry with detailed information including:
- Keyword text and related keyword data (search volume, CPC, keyword difficulty, etc.).
- Ranking details such as absolute rank, rank group, and estimated traffic value.
- Type of search result where the keyword ranks (organic, paid, featured snippet, local pack).
- Additional metadata about the keyword and its performance.
If binary data were involved, it would typically represent downloadable reports or files, but this operation focuses on structured JSON data.
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. - Proper configuration of the API credentials within n8n is necessary.
- Supported locations and languages must be referenced from DataForSEO documentation to ensure valid input values.
Troubleshooting
- Invalid domain format: Ensure the target domain does not include
https://orwww.prefixes. - Unsupported location or language: Use only supported full names as listed in the DataForSEO documentation links provided in the property hints.
- API quota limits: Large limits or frequent requests may hit API rate limits; consider reducing request size or frequency.
- Empty results: Could be due to no rankings found for the domain in the specified location/language or overly restrictive filters.
- Sorting errors: Only up to three sorting rules are allowed; exceeding this may cause errors.
- Filter syntax errors: Filters must follow the exact syntax defined in DataForSEO docs; invalid filters will cause request failures.