Keywords
Keyword Overview
Full per-keyword metrics — search volume, difficulty, intent, CPC, competition, backlinks, and 12-month trend.
POST
$0.02/call/v1/seo/keywords/overviewUsage
const res = await fetch('https://api.yepapi.com/v1/seo/keywords/overview', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ keywords: ['seo api', 'email finder api'] }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/seo/keywords/overview \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords": ["seo api", "email finder api"]}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
keywords | string[] | Yes | Array of keywords to analyze (max 700) | — |
location | string | No | Target country as a two-letter code (e.g., "us", "gb") | "us" |
language | string | No | ISO language code (e.g., en, es) | "en" |
Response
{
"ok": true,
"data": {
"keywords": [
{
"avgBacklinks": 4063.5,
"avgReferringDomains": 803.9,
"competition": 0.37,
"competitionLevel": "MEDIUM",
"cpc": 38.51,
"difficulty": 0,
"intent": "informational",
"keyword": "email finder api",
"serpFeatures": [],
"totalResults": 0,
"trend": [
{
"month": "2026-05",
"volume": 20
},
{
"month": "2026-04",
"volume": 30
},
{
"month": "2026-03",
"volume": 50
}
],
"volume": 40
},
{
"avgBacklinks": 2185.0,
"avgReferringDomains": 141.3,
"competition": 0.1,
"competitionLevel": "LOW",
"cpc": 25.29,
"difficulty": 22,
"intent": "commercial",
"keyword": "seo api",
"serpFeatures": [],
"totalResults": 0,
"trend": [
{
"month": "2026-05",
"volume": 390
},
{
"month": "2026-04",
"volume": 260
},
{
"month": "2026-03",
"volume": 320
}
],
"volume": 480
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.keywords | object[] | Array of keyword overview results |
data.keywords[].keyword | string | The analyzed keyword |
data.keywords[].volume | number | Average monthly search volume |
data.keywords[].difficulty | number | SEO difficulty score (0-100) |
data.keywords[].intent | string | Search intent (informational, commercial, navigational, transactional, or unknown) |
data.keywords[].cpc | number | Cost per click in USD |
data.keywords[].competition | number | PPC competition index (0-1) |
data.keywords[].competitionLevel | string | Competition category (LOW, MEDIUM, HIGH, or unknown) |
data.keywords[].avgBacklinks | number | Average number of backlinks for top-ranking pages |
data.keywords[].avgReferringDomains | number | Average number of referring domains for top-ranking pages |
data.keywords[].serpFeatures | string[] | SERP features present for this keyword (e.g., images, video, peopleAlsoAsk) |
data.keywords[].totalResults | number | Total number of search results |
data.keywords[].trend | object[] | Monthly search volume trend data (up to 12 months) |
data.keywords[].trend[].month | string | Month in YYYY-MM format |
data.keywords[].trend[].volume | number | Search volume for that month |
Under the Hood
Returns the complete metric set for each keyword in one call. For just the difficulty score at higher volume, use Bulk Keyword Difficulty.