scrollport
Back to SEO and search

Keyword Ideas

DataForSEO

Generate related keyword ideas with search demand and competition metrics.

Capability
SEO keyword discovery
Current price
$0.0168/call
Availability
Ready to run
Last accepted verification

What this API does

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; billed output is one live task plus each returned idea.

Agents select this operation with tool ID dataforseo.keyword-ideas, then inspect its current executable contract before a run.

Public input and output shape

Input

closely_variantsboolean · optional

Value supplied for closely variants.

ignore_synonymsboolean · optional

Value supplied for ignore synonyms.

keywordsarray · required

Seed keyword phrases of at most 10 words each.

minItems: 1 · maxItems: 200

language_namestring · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

location_namestring · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

offsetinteger · optional

Value supplied for offset.

minimum: 0 · maximum: 10000

order_byarray · optional

Value supplied for order by.

maxItems: 3

Output

itemsarray

Returned items value.

items_countnumber

Returned items count value.

seed_keywordsarray

Returned seed keywords value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "dataforseo.keyword-ideas",
  "input": {
    "limit": 1,
    "keywords": [
      "seo tools"
    ],
    "language_name": "English",
    "location_name": "United States"
  }
}

Output

{
  "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"
  ]
}
Teaching errors and limitations
  • 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: DataForSEO account access, funding, or cost controls blocked the request.Fund and verify the server-side DataForSEO account, then retry unchanged.
Updated
21 August 2026

Use Keyword Ideas with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.