# Keyword Ideas

DataForSEO

Generate related keyword ideas with search demand and competition 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 Keyword Ideas (tool ID: dataforseo.keyword-ideas). 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 keyword ideas](https://scrollport.com/tools/keyword-research-api)

**Current price:** $0.0168/request

**Availability:** Ready to run

## Tool 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.

**Inputs and outputs**

### Input

`closely_variants` boolean · optional

Value supplied for closely variants.

`ignore_synonyms` boolean · optional

Value supplied for ignore synonyms.

`keywords` array · required

Seed keyword phrases of at most 10 words each.

minItems: 1 · maxItems: 200

`language_name` string · optional

Value supplied for language name.

minLength: 1 · maxLength: 100

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

`location_name` string · optional

Value supplied for location name.

minLength: 1 · maxLength: 200

`offset` integer · optional

Value supplied for offset.

minimum: 0 · maximum: 10000

`order_by` array · optional

Value supplied for order by.

maxItems: 3

### Output

`items` array

Returned items value.

`items_count` number

Returned items count value.

`seed_keywords` array

Returned seed keywords 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.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"
  ]
}
```

**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.

---

Canonical page: https://scrollport.com/tools/providers/dataforseo/keyword-ideas