SERP Competitors

POST/v1/seo/competitors/serp

from $0.03 + $0.03/100 domains

Pricing

$0.03 per call + $0.03 per 100 domains, rounded up to the next whole cent.

Domains returned	Cost per call
1 domain	$0.04
10 domains	$0.04
50 domains	$0.05
100 domains	$0.06
250 domains	$0.11
500 domains	$0.18
1,000 domains	$0.33

Billed on the number of results actually returned, not the number requested. Failed calls are never charged.

Usage

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)