# Keyword research (/docs/seo-research/keywords)



## Expand a seed keyword [#expand-a-seed-keyword]

The default `suggestions` mode returns phrases that contain the seed. Use `related` for semantic neighbors or `ideas` for broader category discovery.

```bash
curl -X POST https://api.trackee.dev/v1/keyword-ideas \
  -H "x-access-key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "project management software",
    "mode": "suggestions",
    "location": "United States",
    "language": "English",
    "limit": 20
  }'
```

Keyword ideas cost 3 credits.

## Save a reusable list [#save-a-reusable-list]

```bash
curl -X PUT https://api.trackee.dev/v1/brands/BRAND_ID/keywords \
  -H "x-access-key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": [
      "project management software",
      "project management tool for startups"
    ]
  }'
```

This replaces the brand's complete keyword list.

## Measure Google demand [#measure-google-demand]

Pass `brandId` to use saved keywords, or send a `keywords` array directly.

```bash
curl -X POST https://api.trackee.dev/v1/keywords \
  -H "x-access-key: YOUR_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brandId": "BRAND_ID",
    "location": "United States",
    "language": "English"
  }'
```

The response includes search volume, CPC, and competition. Keyword metrics cost 1 credit per keyword, with a 20-credit minimum per request. Batch related keywords instead of making many one-keyword calls.

## Measure AI search demand [#measure-ai-search-demand]

[`POST /v1/ai-keyword-volume`](/docs/api/keywords/getAiKeywordVolume) estimates how often keywords are searched in AI assistants and returns a monthly trend. It costs 2 credits per keyword.

See the [keyword ideas](/docs/api/keywords/getKeywordIdeas) and [keyword metrics](/docs/api/keywords/getKeywords) reference pages for complete schemas.