seo_list_keywords
List and audit your brand's SEO keywords with filters for intent, source, volume, difficulty, tags, and more, plus pagination for large sets.
Instructions
List generated keywords for the brand. Useful for auditing between steps. Returns short detail by default: {id, keyword, intent} per keyword. Use detail="medium" for the full compact summary (priority, searchVolume, difficulty, relevance, clusterId, excludedFromClustering, userTags) or detail="full" for raw keyword objects. Supports server-side filtering: source, intent, clusterId, q (substring search), hasTag, volumeMin/volumeMax, kdMin/kdMax, relevanceMin/relevanceMax, priorityMin/priorityMax, includeDeleted, excludedFromClustering. hasTag filters on userTags (OR match) — use it to find geo-tagged keywords after seo_tag_geography, e.g. hasTag="geo:us-mn" or hasTag="geo:us-mn,geo:us-tx" for multiple regions. Use cursor (from a previous call's response) to page through results beyond limit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Substring search over the keyword text | |
| kdMax | No | Maximum keyword difficulty (inclusive) | |
| kdMin | No | Minimum keyword difficulty (inclusive) | |
| limit | No | ||
| cursor | No | Pagination cursor from a previous seo_list_keywords call | |
| detail | No | Verbosity of returned item(s): "short" = id + primary label + status (cheap list scan); "medium" = key summary fields + counts (a useful glance); "full" = the complete object. Default "short". Lists default to "short" — to zoom into one item, call its get/view tool with detail="medium" or "full". | short |
| hasTag | No | CSV of userTags to filter by (OR match), e.g. "geo:us-mn" or "geo:us-mn,geo:us-tx" | |
| intent | No | CSV of search-intent labels to filter by (informational, commercial, navigational, transactional) | |
| source | No | CSV of keyword sources to filter by (e.g. "seed,expanded") | |
| brandId | No | Brand ID (defaults to active brand) | |
| clusterId | No | Filter by cluster ID, or "none" for unclustered, or "any" for any clustered keyword | |
| volumeMax | No | Maximum search volume (inclusive) | |
| volumeMin | No | Minimum search volume (inclusive) | |
| priorityMax | No | Maximum priority score in [0,1] (inclusive) | |
| priorityMin | No | Minimum priority score in [0,1] (inclusive) | |
| relevanceMax | No | Maximum relevance score in [0,1] (inclusive) | |
| relevanceMin | No | Minimum relevance score in [0,1] (inclusive) | |
| includeDeleted | No | Include soft-deleted keywords (default: excluded) | |
| excludedFromClustering | No | Filter to keywords with this excludedFromClustering value |