Keyword Ideas

Generate related keyword ideas with search demand and competition metrics.

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

Example

You ask your agent

“Suggest keyword ideas related to “seo tools” in the US, with their search volumes.”

You get

Keyword: keyword research tools
CPC: 4.2
Competition: 0.28
Search volume: 2400
Keyword difficulty: 45

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.keyword-ideas",
  "input": {
    "limit": 1,
    "keywords": [
      "seo tools"
    ],
    "language_name": "English",
    "location_name": "United States"
  }
}

Response

{
  "items": [
    {
      "keyword": "keyword research tools",
      "keyword_info": {
        "cpc": 4.2,
        "competition": 0.28,
        "search_volume": 2400
      },
      "keyword_properties": {
        "keyword_difficulty": 45
      }
    }
  ],
  "items_count": 1,
  "seed_keywords": [
    "seo tools"
  ]
}

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 Keyword Ideas (tool ID: dataforseo.keyword-ideas). 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.

Questions

Is Keyword Ideas 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

Finds category-relevant Google keyword ideas for a bounded seed set and location. Results include keyword demand, CPC, paid competition and SEO difficulty. Clickstream enrichment is intentionally unavailable because it doubles supplier cost; the upfront request quote includes the live task and requested idea limit. A completed search costs that quote, including a valid empty answer.

All inputs and outputs

Input

closely_variantsboolean · optional

ignore_synonymsboolean · optional

keywordsarray · required

Seed keyword phrases of at most 10 words each.

minItems: 1 · maxItems: 200

language_namestring · optional

Language of the results.

minLength: 1 · maxLength: 100

limitinteger · optional

Maximum number of results to return.

minimum: 1 · maximum: 1000

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: 10000

order_byarray · optional

Sort order for the results.

maxItems: 3

Output

itemsarray

Result records.

items_countnumber

Number of items returned.

seed_keywordsarray

Errors and limits

invalid_input: Provide 1–200 seed keywords and a result limit from 1 to 1,000.example: {"keywords":["seo tools"],"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.