---
title: "Keyword ideas from seed keywords"
method: POST
path: "/v1/data/seo/keyword-ideas"
tags: ["SEO: Keywords"]
---

# Keyword ideas from seed keywords

`POST /v1/data/seo/keyword-ideas`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/seo/keyword-ideas`
- Auth: API key in header `Authorization`

Expands up to 200 seed keywords into related keyword ideas, each with search volume, CPC, competition and keyword difficulty (difficulty is at keyword_properties.keyword_difficulty in each row; volume and CPC at keyword_info). Ideas come from category-level expansion, so sorting by search volume surfaces unrelated head terms; the default order is relevance, keep it for topical work and filter instead. Cost scales with rows returned, so keep `limit` at the default 100 unless the task genuinely needs more (hard cap 1000).

## Request body

- object
  - `keywords` string[], required: Seed keywords to expand (1-200).
  - `location_code` integer: Geo target as a location code. Default 2840 (United States).
  - `language_code` string: Two-letter language code. Default 'en'.
  - `limit` integer: Max keyword ideas to return. Default 100. Cost scales with rows, so raise only when needed.
  - `offset` integer: Pagination offset.
  - `filters` unknown[]: Optional filter expression as [field, operator, value] triples joined by 'and'/'or'. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like (use %% wildcards with like). Recipes: [["keyword_info.search_volume",">",100]] · keep only on-topic ideas: [["keyword","like","%deliverability%"]] · combine: [["keyword_info.search_volume",">",100],"and",["keyword_properties.keyword_difficulty","<",40]].
    - unknown
  - `order_by` string[]: Sort rules, e.g. ["keyword_info.search_volume,desc"].

## Response `200`

Keyword ideas with volume, CPC, competition and difficulty in `result[0].items`.

- object

## Other responses

- `400`: Bad request or upstream task error.
- `401`: Unauthorized.
- `429`: Too many requests.
- `5XX`: Upstream error.

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)