Keyword metrics

Research a keyword: search volume, clicks, cost per click, difficulty, global volume, and traffic potential for a target country.

← All SEO endpoints · Capability overview

GET/v1/seo/keyword-metrics

https://api.vee3.io/v1/seo/keyword-metrics

10 tokens

Research a keyword: search volume, clicks, cost per click, difficulty, global volume, and traffic potential for a target country.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_seo_keyword_metrics

Parameters2 fields

keywordstringRequired

Search keyword or phrase to analyze.

max length 512

countrystringRequired

2-letter ISO country code for the target market (default us). Use list_seo_country_codes for supported values.

Default: "us" · max length 2

Response7 fields

keywordstring

Analyzed keyword.

searchVolumeinteger

Estimated monthly search volume in the selected country.

clicksinteger

Estimated monthly clicks from organic search.

cpcnumber

Estimated cost per click in paid search.

difficultyinteger

Keyword difficulty score (higher is harder to rank).

globalSearchVolumeinteger

Estimated global monthly search volume.

trafficPotentialinteger

Estimated traffic potential if ranking well.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, seo_not_configured, seo_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/seo/keyword-metrics"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "keyword": "fishing",
    "country": "us"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample keyword metrics for fishing.

fishing_metrics.json

{
  "keyword": "fishing",
  "searchVolume": 89000,
  "clicks": 33000,
  "cpc": 0.15,
  "difficulty": 46,
  "globalSearchVolume": 229000,
  "trafficPotential": 6300
}