> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# How do I check search volume and difficulty for a keyword list?

> Send up to 100 keywords for one country and language in the keywords array of POST /v1/seo/keyword-overview to receive search_volume, keyword_difficulty, intent, and monthly_searches synchronously.

Send up to 100 keywords for a single market in the `keywords` array to `POST /v1/seo/keyword-overview`. The endpoint responds synchronously with volume, difficulty, commercial metrics, search intent, and monthly history for each matched keyword.

## Batch inputs and market rules

* **Batch limits**: `keywords` accepts `1–100` strings of up to 80 characters each. The gateway lowercases terms and deduplicates repeated entries automatically.
* **Single market per call**: Pair `country` (two-letter code, default `us`) with `language` (defaults to the market's main language). Send separate requests for additional countries or languages.

```bash
curl -sS https://api.beatapi.io/v1/seo/keyword-overview \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["<keyword_1>","<keyword_2>"],"country":"us","language":"en"}'
```

For a US English maintenance section, send terms such as `"descale coffee machine"` and `"clean coffee grinder"` together with `"country": "us"` and `"language": "en"`.

## Read and store returned metrics

From each entry in `results`, record `search_volume`, `cpc_usd`, `competition`, `keyword_difficulty`, `intent`, `updated_at`, and `monthly_searches`. `search_volume` sizes demand, `keyword_difficulty` scores ranking competition on the dataset's `0–100` scale, and `intent` separates tutorial topics from buying guides. Leave omitted fields blank rather than substituting zero. When only difficulty scores are needed, `POST /v1/seo/keyword-difficulty` accepts the same request format.

## Contracts and related questions

Before sending a paid request, inspect the SEO contracts for free: `data:seo.keyword_overview`, `data:seo.ranked_keywords`, `data:seo.top_pages`, `data:seo.backlinks`.

[Back to SEO questions](/faq/seo).