Skip to navigation

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

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.
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.

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.