scrollport

Ranked Keywords

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

by DataForSEOReady to run$0.0168 per request · $1.68 per 100 requests

Example

You ask your agent

“Which keywords does dataforseo.com rank for in US Google search?”

You get

Keyword
dataforseo
CPC
1.5
Search volume
1000
SERP item URL
https://dataforseo.com/
SERP item type
organic
Rank group
1
What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

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

Response

{
  "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
}

Use it with your agent

Copy the prompt and paste it into your agent, then 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.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 6 →

Questions

Is Ranked Keywords by DataForSEO free?

Scrollport has no free tier: it costs $0.0168 per request ($1.68 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from DataForSEO?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to DataForSEO, so you don't sign up with DataForSEO or manage an API key.

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.

All inputs and outputs

Input

historical_serp_modestring · optional

enum: live, lost, all

ignore_synonymsboolean · optional
item_typesarray · optional

minItems: 1 · maxItems: 5

language_namestring · optional

Language of the results.

minLength: 1 · maxLength: 100

limitinteger · optional

Maximum number of results to return.

minimum: 1 · maximum: 1000

load_rank_absoluteboolean · optional
location_namestring · optional

Location the results are localised to.

minLength: 1 · maxLength: 200

offsetinteger · optional

Number of results to skip before this page starts.

minimum: 0 · maximum: 100000000

order_byarray · optional

Sort order for the results.

maxItems: 3

targetstring · required

Domain, URL or page to analyse.

minLength: 1 · maxLength: 2000

Output

itemsarray

Result records.

items_countnumber

Number of items returned.

targetstring
total_countnumber

Total number of matching results.

Errors and limits
  • invalid_input: target is requiredexample: {"target":"dataforseo.com","location_name":"United States","language_name":"English","limit":1}
  • configuration_error: This tool's provider API is currently overloaded or down. Your wallet was not charged.Try again in a few minutes.