# Ranked Keywords

DataForSEO

Return keywords for which a domain ranks with positions, URLs and search metrics.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Ranked Keywords (tool ID: dataforseo.ranked-keywords). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Find a site's ranking keywords](https://scrollport.com/tools/ranked-keywords-api)

**Current price:** $0.0168/request

**Availability:** Ready to run

## Tool details

**About this tool**

Returns Google keywords for which a target domain, subdomain or URL ranks, including the matching SERP element and keyword metrics. Uses standard DataForSEO Labs data only; clickstream fields are deliberately excluded because they have a different supplier price. Billed as one live task plus each returned keyword.

**Inputs and outputs**

### Input

`historical_serp_mode` string · optional

Value supplied for historical serp mode.

enum: live, lost, all

`ignore_synonyms` boolean · optional

Value supplied for ignore synonyms.

`item_types` array · optional

Value supplied for item types.

minItems: 1 · maxItems: 5

`language_name` string · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

`load_rank_absolute` boolean · optional

Value supplied for load rank absolute.

`location_name` string · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

`offset` integer · optional

Value supplied for offset.

minimum: 0 · maximum: 100000000

`order_by` array · optional

Value supplied for order by.

maxItems: 3

`target` string · required

Value supplied for target.

minLength: 1 · maxLength: 2000

### Output

`items` array

Returned items value.

`items_count` number

Returned items count value.

`target` string

Returned target value.

`total_count` number

Returned total count value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "dataforseo.ranked-keywords",
  "input": {
    "limit": 1,
    "target": "dataforseo.com",
    "item_types": [
      "organic"
    ],
    "language_name": "English",
    "location_name": "United States"
  }
}
```

### Output

```
{
  "items": [
    {
      "keyword_data": {
        "keyword": "dataforseo",
        "keyword_info": {
          "cpc": 1.5,
          "search_volume": 1000
        }
      },
      "ranked_serp_element": {
        "serp_item": {
          "url": "https://dataforseo.com/",
          "type": "organic",
          "rank_group": 1
        }
      }
    }
  ],
  "target": "dataforseo.com",
  "items_count": 1,
  "total_count": 1
}
```

**Errors and limitations**

- `invalid_input`: target is requiredexample: {"target":"dataforseo.com","location_name":"United States","language_name":"English","limit":1}
- `configuration_error`: DataForSEO account access, funding, or cost controls blocked the request.Fund and verify the server-side DataForSEO account, then retry unchanged.

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/ranked-keywords