---
title: "Get Top SEO Competitors"
method: GET
path: "/v2/seo/getTopCompetitors"
tags: ["Competitors API"]
---

# Get Top SEO Competitors

`GET /v2/seo/getTopCompetitors`

## Request

- Base URL: `https://api.spyfu.com/apis/competitors_api`
- URL: `https://api.spyfu.com/apis/competitors_api/v2/seo/getTopCompetitors`
- Auth: one of:
  - HTTP basic
  - API key in query parameter `api_key`
  - API key in header `Authentication`

Returns the top organic search (SEO) competitors for a domain based on shared keyword ranking overlap. This endpoint identifies domains that compete for the same organic keywords to reveal direct SEO competition and content opportunities.

[Visualize this API live on SpyFu](https://www.spyfu.com/seo/competitors?query=example.com)

## Query parameters

- `domain` string, required
- `countryCode` 'AR' | 'AT' | 'AU' | 'BE' | 'BR' | 'CA' | 'CH' | 'DE' | 'DK' | 'ES' | 'FR' | 'IE' | 'IN' | 'IT' | 'JP' | 'MX' | 'NL' | 'NO' | 'NZ' | 'PL' | 'PT' | 'SE' | 'SG' | 'TR' | 'UA' | 'UK' | 'US' | 'ZA'
- `sortBy` 'Domain' | 'CommonTerms' | 'Rank'
- `sortOrder` 'Ascending' | 'Descending'
- `pageSize` integer
- `startingRow` integer

## Response `200`

Successfully retrieved SEO competitor data. Returns a paginated list of domains competing for shared organic keywords with overlap metrics and ranking strength indicators.

- object: Response wrapper containing competitor analysis data for a specific search channel (SEO or PPC) with pagination metadata.
  - `resultCount` integer: Number of results returned
  - `totalMatchingResults` integer: Total number of competitor domains available that match the query criteria, including results not included in the current page.
  - `results` object[], nullable: Array of competitor domains ranked by keyword overlap strength in the specified search channel.
    - `domain` string, nullable: Domain name of the competitor that shares significant keyword overlap in the specified search channel (SEO or PPC).
    - `commonTerms` integer: Number of unique keywords that both this competitor domain and the target domain compete for in the same search channel.
    - `rank` number, float: The rank is a metric for how much overlap there is between your domain and the competitor

## Other responses

- `400`: Bad Request - Invalid parameters provided (e.g., invalid domain format, pageSize exceeds maximum, or invalid country code)
- `401`: Unauthorized - Invalid API credentials or insufficient permissions to access SEO competitor data
- `500`: Internal Server Error - A server-side error occurred while processing the request

---

[API](https://skmtc.dev/spyfu/apis/competitors-api.md) - [All operations](https://skmtc.dev/spyfu/apis/competitors-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spyfu/apis/competitors-api/revisions/3ee503ed63d6?raw)