export const metadata = {
  title: "Keyword reservoir: SEO Insight Docs",
  description:
    "Query the multi-source keyword reservoir: volume, KD, CPC, trends, intent and GSC quick-wins.",
};

# Keyword reservoir

The reservoir is a single, deduplicated store of every keyword across your
sources. Each keyword keeps its **source** and **update date**, so imports never
silently overwrite each other.

## Fields

Every keyword carries:

- `volume`: monthly search volume
- `kd`: keyword difficulty (0 to 100)
- `cpc`: cost per click
- `trend`: 12 months of volume history
- `intent`: informational, commercial, transactional or navigational
- `position`: your current ranking, when connected to Search Console

## List keywords

```bash
curl https://api.seoinsight.app/v1/keywords \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY" \
  -G -d "intent=commercial" -d "limit=20"
```

## Quick-wins

Quick-wins are keywords ranking in positions 11 to 20, close to page one. Filter
for them to prioritise the work with the highest expected return:

```bash
curl "https://api.seoinsight.app/v1/keywords?quick_wins=true" \
  -H "Authorization: Bearer $SEO_INSIGHT_API_KEY"
```

This is the same data the [MCP server](/docs/mcp) exposes to agents.