SEO API · Keyword Metrics by Country

Keyword Metrics by Country

Localized metrics for up to 1000 keywords in one country.

Send a list of keywords and a country and get back each keyword's search volume, CPC range, competition, difficulty, intent and 12-month trend for that specific market. The language is derived from the country automatically.

POST /api/v1/keywords/country $0.01 / request + $0.001 / started 10 keywords

Get API Key

Use your Seonio API key instantly.

Open Playground

curl

curl -X POST https://seonio.com/api/v1/keywords/country \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $SEONIO_API_KEY" \
  -d '{"country": "de", "keywords": ["seo tools", "keyword research"]}'

Sample response

{
  "country": "de",
  "keywords": [
    {
      "competition": 58,
      "cpc": 640,
      "difficulty": 61,
      "high_cpc": 1120,
      "intent": "commercial",
      "low_cpc": 280,
      "monthly_trend": [
        {
          "month": "2026-05",
          "value": 8100
        },
        {
          "month": "2026-04",
          "value": 6600
        },
        {
          "month": "2026-03",
          "value": 6600
        }
      ],
      "text": "seo tools",
      "volume": 8100
    },
    {
      "competition": 52,
      "cpc": 590,
      "difficulty": 57,
      "high_cpc": 990,
      "intent": "informational",
      "low_cpc": 240,
      "monthly_trend": [
        {
          "month": "2026-05",
          "value": 5400
        },
        {
          "month": "2026-04",
          "value": 4400
        },
        {
          "month": "2026-03",
          "value": 4400
        }
      ],
      "text": "keyword research",
      "volume": 5400
    }
  ]
}

Request and response

The full contract for /api/v1/keywords/country — what to send and what comes back.

Request body

keywords string[] required

1–1000 keywords to look up in the given country. Billed per request plus each started block of 10 keywords.

country string optional

Two-letter ISO country code (default "us"). The language is derived from it.

Response fields

`country`	string	The country the metrics were resolved for. Supported countries `in` India `vn` Vietnam `us` United States `gb` United Kingdom `de` Germany `pk` Pakistan `bd` Bangladesh `ca` Canada `tr` Turkiye `id` Indonesia `fr` France `es` Spain `nl` Netherlands `it` Italy `au` Australia `ae` United Arab Emirates `ph` Philippines `ch` Switzerland `jp` Japan `ng` Nigeria `eg` Egypt `th` Thailand `za` South Africa `mx` Mexico `sg` Singapore `ke` Kenya `at` Austria `ma` Morocco `pl` Poland `dk` Denmark `my` Malaysia `sa` Saudi Arabia `lk` Sri Lanka `ro` Romania `gh` Ghana `fi` Finland `se` Sweden `be` Belgium `br` Brazil `ie` Ireland `bg` Bulgaria `gr` Greece `nz` New Zealand `rs` Serbia `dz` Algeria `no` Norway `hu` Hungary `ar` Argentina `pt` Portugal `cz` Czechia
`keywords[].text`	string	The keyword. Keywords with no data are omitted.
`keywords[].volume`	integer	Average monthly search volume in the country.
`keywords[].cpc`	integer	Cost-per-click indicator.
`keywords[].low_cpc`	integer	Low top-of-page bid indicator.
`keywords[].high_cpc`	integer	High top-of-page bid indicator.
`keywords[].competition`	integer	Competition score (0–100).
`keywords[].difficulty`	integer	Keyword difficulty (0–100).
`keywords[].intent`	string	Dominant search intent for the keyword.
`keywords[].monthly_trend`	object[]	Monthly trend points, newest to oldest, each as { month: YYYY-MM, value }.

Code examples

Copy, paste, swap in your API key.

curl -X POST https://seonio.com/api/v1/keywords/country \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"country": "de", "keywords": ["seo tools", "keyword research"]}'

import requests

resp = requests.post(
    "https://seonio.com/api/v1/keywords/country",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"country": "de", "keywords": ["seo tools", "keyword research"]},
)
print(resp.json())

const resp = await fetch("https://seonio.com/api/v1/keywords/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
  body: JSON.stringify({"country": "de", "keywords": ["seo tools", "keyword research"]}),
});
console.log(await resp.json());

Playground

Run a real /api/v1/keywords/country request. No key? We show the real sample result so you can still inspect the shape.

API key

JSON body

Leave the API key empty to load the built-in sample response.

Request

POST /api/v1/keywords/country

sample mode

What developers build with it

Common ways Keyword Metrics by Country ends up in production.

Localizing keyword research to a specific market.

Comparing demand for the same keywords across countries.

Bulk-checking volume and difficulty before targeting a region.

Status codes

The same predictable contract on every endpoint.

`200`	Success. The lookup completed and was charged, even if the response is empty.
`401`	Missing or unknown API key.
`402`	Not enough balance on the account.
`422`	Invalid request body (wrong shape or types).
`429`	Account rate limit exceeded (20 requests per second).

Other endpoints

Explore the rest of the SEO API.

$0.001 / keyword

Keyword Research

/api/v1/keywords/global

Volume, CPC, competition and a 12-month trend for up to 100 keywords in one call.

View API docs

$0.01 / request

Keyword Countries

/api/v1/keywords/countries

Top five countries by keyword volume.

View API docs

$0.005 / request

Keyword Difficulty

/api/v1/keywords/difficulty

Country-specific ranking difficulty.

View API docs

$0.001 / request

Keyword Intent

/api/v1/keywords/intent

Search-intent classification.

View API docs

$0.01 / request

Keyword Demographics

/api/v1/keywords/demographics

Age and gender demand distribution.

View API docs

$0.25 / request

Keyword Clustering

/api/v1/keywords/clustering

Group a keyword's universe into topic clusters by SERP overlap.

View API docs

$0.02 / request

Keyword Suggestions

/api/v1/keywords/suggestions

Up to 100 related keyword ideas — each with full metrics — from one seed keyword.

View API docs

$0.001 / request

SERP

/api/v1/serp/country

Google organic results, People Also Ask and related searches for a keyword and country.

View API docs

$0.001 / request + $0.002 / scraped URL

SERP Scraper

/api/v1/serp/scraper

Run a Google search and get the top results scraped to clean markdown in one call.

View API docs

$0.002 / request

Scraper

/api/v1/scraper

Scrape a supported URL to clean, LLM-ready markdown in one call.

View API docs

$0.01 / request

Website Traffic

/api/v1/website/traffic

Monthly organic traffic history for any domain.

View API docs

$0.02 / request

Website Ranking

/api/v1/website/ranking

A domain's full ranking footprint: countries, distribution, movers, top keywords and pages.

View API docs

$0.001 / request

Website Category

/api/v1/website/category

Taxonomy classification for a domain.

View API docs

$0.01 / request

Website Competitors

/api/v1/website/competitors

Ordered organic competitors.

View API docs

$0.001 / request

Similar Websites

/api/v1/website/similar

Traffic-ranked sites in the same category.

View API docs

$0.002 / request

URL Stats

/api/v1/url/stats

Page- and domain-level authority metrics for a specific URL.

View API docs

$0.02 / request

URL Keywords

/api/v1/url/keywords

Top organic keywords for one URL.

View API docs

$0.002 / request

Website Stats

/api/v1/website/stats

Domain-level authority metrics for a bare domain.

View API docs

$0.02 / request

Backlink History

/api/v1/backlink/history

Historical backlink counts for a domain.

View API docs

$0.02 / request

Backlink Table

/api/v1/backlink/table

Detailed backlinks for a domain or URL.

View API docs

$0.005 / request

SEO Page Checker

/api/v1/audit/page-checker

On-page SEO report and response timing.

View API docs

FAQ

Simple answers for developers using the API.

Pricing & Balance

Every endpoint has a published USD price or formula. Requests draw from the same included and Extra Usage balance as website and MCP actions.

Testing balance is spent first. Active subscribers then use included usage and Extra Usage expiring soonest. Every amount is displayed in dollars.

New Extra Usage is valid for one year. Included usage is replaced at each subscription-month boundary based on the active tier.

API & Integration

API actions require a verified account with a testing balance or active subscription balance. Create and manage API keys from your account, then send the key in the X-API-Key header.

Yes. Your dashboard shows your API usage and remaining balance, so you can track costs while building and running automated workflows.

We currently cover 50 markets. We add new countries regularly.

Algeria Argentina Australia Austria Bangladesh Belgium Brazil Bulgaria Canada Czechia Denmark Egypt Finland France Germany Ghana Greece Hungary India Indonesia Ireland Italy Japan Kenya Malaysia Mexico Morocco Netherlands New Zealand Nigeria Norway Pakistan Philippines Poland Portugal Romania Saudi Arabia Serbia Singapore South Africa Spain Sri Lanka Sweden Switzerland Thailand Turkiye United Arab Emirates United Kingdom United States Vietnam

Email support is available for account, billing, and API integration questions at [email protected].

The account-wide limit is 20 requests per second across website, REST API, and MCP data actions. Requests above it return HTTP 429.

Start free

$1 testing balance • No card required • Subscribe when ready

Get Started for Free