scrollport

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
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_modestring · optional

Value supplied for historical serp mode.

enum: live, lost, all

ignore_synonymsboolean · optional

Value supplied for ignore synonyms.

item_typesarray · optional

Value supplied for item types.

minItems: 1 · maxItems: 5

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

load_rank_absoluteboolean · optional

Value supplied for load rank absolute.

location_namestring · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

offsetinteger · optional

Value supplied for offset.

minimum: 0 · maximum: 100000000

order_byarray · optional

Value supplied for order by.

maxItems: 3

targetstring · required

Value supplied for target.

minLength: 1 · maxLength: 2000

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

targetstring

Returned target value.

total_countnumber

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.