Competitors API

Get Top PPC Competitors

Returns the top paid search (PPC) competitors for a domain based on shared keyword advertising overlap. This endpoint identifies domains that compete for the same paid keywords to reveal direct advertising competition and bidding opportunities.

Visualize this API live on SpyFu

get/v2/ppc/getTopCompetitors

Request

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

Query parameters

domainstring required

Example:example.com

Domain to analyze for paid search competitors.

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 PPC competitor data. Returns a paginated list of domains competing for shared paid keywords with overlap metrics and advertising 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": 2500,
  "results": [
    {
      "domain": "example.com",
      "commonTerms": 1432
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.