v1

latestOpenAPI 3.1.02026-07-24490622.0 KB

Competitors API

Get Combined Top Competitors

Returns the top competitors for a domain combining both paid search (PPC) and organic search (SEO) data. This endpoint identifies domains that compete across both advertising and organic rankings to reveal comprehensive competitive landscape insights.

Visualize this API live on SpyFu

get/v2/combined/getCombinedTopCompetitors

Query parameters

domainstring required

Example:example.com

Domain to get competitors for

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'

Example:US

Country market to search. Specifically, this maps to the Google domain version to query against (e.g., google.com for US, google.de for Germany, etc.). <a href='https://developer.spyfu.com/reference/adhistoryapi_getdomainadhistory_get#/'>All Countries</a>

sortBy'Domain' | 'CommonTerms' | 'Rank'

Example:Rank

Column to sort by.

sortOrder'Ascending' | 'Descending'

Example:Descending

Order to sort results.

pageSizeinteger

Example:5

The maximum number of rows returned.

startingRowinteger

Example:1

Row number to start the results with.

Response

Successfully retrieved combined competitor data. Returns a paginated list of domains competing in both paid and organic search with overlap metrics and competitive strength indicators.

resultCountinteger

Number of results returned

totalMatchingResultsinteger

Total number of competitor domains available that match the query criteria, including results not included in the current page.

Example response

{
  "resultCount": 50,
  "totalMatchingResults": 5000,
  "combinedCompetitors": [
    {
      "rank": 1,
      "domain": "example.com"
    }
  ],
  "ppcCompetitors": [
    {
      "domain": "example.com",
      "commonTerms": 1432
    }
  ],
  "seoCompetitors": [
    {
      "domain": "example.com",
      "commonTerms": 1432
    }
  ]
}