Competitors
SERP Competitors
Find which domains compete for your target keywords in search results.
POST
from $0.02/call/v1/seo/competitors/serpUsage
const res = await fetch('https://api.yepapi.com/v1/seo/competitors/serp', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
keywords: ['seo tools', 'keyword research', 'backlink checker'],
location_code: 2840,
language: 'en',
limit: 100,
}),
});
const { data } = await res.json();
console.log(data.competitors);curl -X POST https://api.yepapi.com/v1/seo/competitors/serp \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords": ["seo tools", "keyword research"], "location_code": 2840, "language": "en", "limit": 100}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
keywords | string[] | Yes | Keywords to analyze (up to 200) | — |
location_code | number | No | Target country code. See Location Codes. | 2840 |
language | string | No | ISO language code | "en" |
limit | number | No | Max competitor domains to return | 100 |
Response
{
"ok": true,
"data": {
"competitors": [
{
"avgPosition": 1.0,
"domain": "nextjs.org",
"etv": 15048.0,
"keywordsCount": 1,
"medianPosition": 1,
"rating": 99,
"visibility": 1.0
},
{
"avgPosition": 2.0,
"domain": "en.wikipedia.org",
"etv": 8019.0,
"keywordsCount": 1,
"medianPosition": 2,
"rating": 98,
"visibility": 0.9
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.competitors | array | List of competing domains for the given keywords |
data.competitors[].domain | string | Competitor domain name |
data.competitors[].avgPosition | number | Average ranking position across the target keywords |
data.competitors[].medianPosition | number | Median ranking position across the target keywords |
data.competitors[].rating | number | Competitor relevance rating (0-100, higher = more competitive) |
data.competitors[].etv | number | Estimated traffic value from the target keywords (USD) |
data.competitors[].keywordsCount | number | Number of target keywords this competitor ranks for |
data.competitors[].visibility | number | Search visibility score (0-1, higher = more visible) |