Actions29
- 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 fetches a list of keywords for which a specified domain ranks in search engine results. It provides detailed ranking data including keyword metrics, position, and types of search results where the domain appears (organic, paid, featured snippets, local pack). This node is useful for SEO professionals and digital marketers who want to analyze their website's keyword rankings, track performance over time, or identify opportunities for optimization.
Practical examples:
- Retrieve the top 1000 keywords your domain ranks for in a specific location and language.
- Filter keywords by type of search result (e.g., only organic results).
- Sort keywords by search volume or cost per click to prioritize SEO efforts.
Properties
| Name | Meaning |
|---|---|
| Target Domain | The domain to analyze, specified without https:// or www. (e.g., example.com). |
| Location | Full name of the geographic location to target (e.g., "United States"). Supported locations are listed in the DataForSEO documentation. |
| Language | Full name of the language to target (e.g., "English"). Supported languages are listed in the DataForSEO documentation. |
| Ignore Synonyms | Boolean flag to exclude highly similar keywords, returning only core keywords if set to true. |
| Limit (up to 1000) | Maximum number of keywords to return, between 1 and 1000. Defaults to 100. |
| Offset | Number of keywords to skip before starting to collect results, used for pagination. Defaults to 0. |
| Item Types | Types of search results to include: 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). |
| Filters | String containing filters to narrow down the keyword results based on supported fields (see DataForSEO documentation). |
Output
The output is a JSON array where each item represents a ranked keyword 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.
- Types of search results where the domain appears for that keyword (organic, paid, featured snippet, local pack).
- Additional metadata depending on the API response structure.
If binary data were returned (not indicated here), it would typically represent downloadable files or media, but this operation focuses on JSON keyword ranking data.
Dependencies
- Requires an active API key credential for the DataForSEO service.
- The node makes POST requests to the DataForSEO v3 API endpoint (
https://api.dataforseo.com/v3). - Users must ensure correct configuration of credentials within n8n.
- Supported locations and languages must be valid as per DataForSEO documentation.
Troubleshooting
- Invalid domain format: Ensure the target domain does not include
https://orwww.prefixes. - Unsupported location or language: Verify that the location and language names exactly match those supported by DataForSEO.
- Limit exceeding 1000: The API restricts the maximum limit to 1000; setting higher values will cause errors.
- Empty results: Could be due to no rankings for the domain in the specified location/language or overly restrictive filters.
- API authentication errors: Check that the API key credential is correctly configured and has sufficient permissions.
- Sorting or filter syntax errors: Refer to the DataForSEO documentation for correct usage of sorting and filtering parameters.