SpyFu Competitors API
The Competitors API API from SpyFu — 3 operation(s) for competitors api.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/spyfu:spyfu-competitors-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Competitors API
version: v2
description: Discover and analyze your most significant competitors across both paid and organic search channels to uncover market opportunities and strategic insights.
servers:
- url: https://api.spyfu.com/apis/competitors_api
security:
- Basic_Authentication_Token: []
- Query_Parameter_Token: []
- HMAC_Authentication_Header: []
tags:
- name: Competitors API
paths:
/v2/ppc/getTopCompetitors:
get:
operationId: CompetitorsApi_GetTopPpcCompetitors_GET
summary: Get Top PPC Competitors
description: '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'
parameters:
- name: domain
in: query
description: Domain to analyze for paid search competitors.
required: true
schema:
type: string
example: example.com
example: example.com
- name: countryCode
in: query
description: 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>
schema:
type: string
default: US
enum:
- 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
example: US
- name: sortBy
in: query
description: Column to sort by.
schema:
type: string
default: Rank
enum:
- Domain
- CommonTerms
- Rank
example: Rank
example: Rank
- name: sortOrder
in: query
description: Order to sort results.
schema:
type: string
default: Descending
enum:
- Ascending
- Descending
example: Descending
example: Descending
- name: pageSize
in: query
description: The maximum number of rows returned.
schema:
type: integer
format: int32
default: 5
maximum: 550
minimum: 1
example: 5
example: 5
- name: startingRow
in: query
description: Row number to start the results with.
schema:
type: integer
format: int32
default: 1
maximum: 550
minimum: 1
example: 1
example: 1
responses:
'200':
description: Successfully retrieved PPC competitor data. Returns a paginated list of domains competing for shared paid keywords with overlap metrics and advertising strength indicators.
content:
application/json:
schema:
description: Response wrapper containing competitor analysis data for a specific search channel (SEO or PPC) with pagination metadata.
type: object
properties:
resultCount:
description: Number of results returned
type: integer
format: int32
readOnly: true
example: 50
totalMatchingResults:
description: Total number of competitor domains available that match the query criteria, including results not included in the current page.
type: integer
format: int64
readOnly: true
example: 2500
results:
description: Array of competitor domains ranked by keyword overlap strength in the specified search channel.
type:
- array
- 'null'
items:
type: object
properties:
domain:
description: Domain name of the competitor that shares significant keyword overlap in the specified search channel (SEO or PPC).
type:
- string
- 'null'
example: example.com
commonTerms:
description: Number of unique keywords that both this competitor domain and the target domain compete for in the same search channel.
type: integer
format: int32
example: 1432
rank:
description: The rank is a metric for how much overlap there is between your domain and the competitor
type: number
format: float
additionalProperties: false
description: Represents a competitor domain with shared keyword overlap data, indicating the strength of competitive relationship in either paid or organic search.
readOnly: true
additionalProperties: false
'400':
description: Bad Request - Invalid parameters provided (e.g., invalid domain format, pageSize exceeds maximum, or invalid country code)
'401':
description: Unauthorized - Invalid API credentials or insufficient permissions to access PPC competitor data
'500':
description: Internal Server Error - A server-side error occurred while processing the request
tags:
- Competitors API
/v2/seo/getTopCompetitors:
get:
operationId: CompetitorsApi_GetTopSeoCompetitors_GET
summary: Get Top SEO Competitors
description: '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'
parameters:
- name: domain
in: query
description: Domain to analyze for organic search competitors.
required: true
schema:
type: string
example: example.com
example: example.com
- name: countryCode
in: query
description: 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>
schema:
type: string
default: US
enum:
- 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
example: US
- name: sortBy
in: query
description: Column to sort by.
schema:
type: string
default: Rank
enum:
- Domain
- CommonTerms
- Rank
example: Rank
example: Rank
- name: sortOrder
in: query
description: Order to sort results.
schema:
type: string
default: Descending
enum:
- Ascending
- Descending
example: Descending
example: Descending
- name: pageSize
in: query
description: The maximum number of rows returned.
schema:
type: integer
format: int32
default: 5
maximum: 550
minimum: 1
example: 5
example: 5
- name: startingRow
in: query
description: Row number to start the results with.
schema:
type: integer
format: int32
default: 1
maximum: 550
minimum: 1
example: 1
example: 1
responses:
'200':
description: Successfully retrieved SEO competitor data. Returns a paginated list of domains competing for shared organic keywords with overlap metrics and ranking strength indicators.
content:
application/json:
schema:
description: Response wrapper containing competitor analysis data for a specific search channel (SEO or PPC) with pagination metadata.
type: object
properties:
resultCount:
description: Number of results returned
type: integer
format: int32
readOnly: true
example: 50
totalMatchingResults:
description: Total number of competitor domains available that match the query criteria, including results not included in the current page.
type: integer
format: int64
readOnly: true
example: 2500
results:
description: Array of competitor domains ranked by keyword overlap strength in the specified search channel.
type:
- array
- 'null'
items:
type: object
properties:
domain:
description: Domain name of the competitor that shares significant keyword overlap in the specified search channel (SEO or PPC).
type:
- string
- 'null'
example: example.com
commonTerms:
description: Number of unique keywords that both this competitor domain and the target domain compete for in the same search channel.
type: integer
format: int32
example: 1432
rank:
description: The rank is a metric for how much overlap there is between your domain and the competitor
type: number
format: float
additionalProperties: false
description: Represents a competitor domain with shared keyword overlap data, indicating the strength of competitive relationship in either paid or organic search.
readOnly: true
additionalProperties: false
'400':
description: Bad Request - Invalid parameters provided (e.g., invalid domain format, pageSize exceeds maximum, or invalid country code)
'401':
description: Unauthorized - Invalid API credentials or insufficient permissions to access SEO competitor data
'500':
description: Internal Server Error - A server-side error occurred while processing the request
tags:
- Competitors API
/v2/combined/getCombinedTopCompetitors:
get:
operationId: CompetitorsApi_GetCombinedTopCompetitors_GET
summary: Get Combined Top Competitors
description: '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'
parameters:
- name: domain
in: query
description: Domain to get competitors for
required: true
schema:
type: string
example: example.com
example: example.com
- name: countryCode
in: query
description: 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>
schema:
type: string
default: US
enum:
- 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
example: US
- name: sortBy
in: query
description: Column to sort by.
schema:
type: string
default: Rank
enum:
- Domain
- CommonTerms
- Rank
example: Rank
example: Rank
- name: sortOrder
in: query
description: Order to sort results.
schema:
type: string
default: Descending
enum:
- Ascending
- Descending
example: Descending
example: Descending
- name: pageSize
in: query
description: The maximum number of rows returned.
schema:
type: integer
format: int32
default: 5
maximum: 550
minimum: 1
example: 5
example: 5
- name: startingRow
in: query
description: Row number to start the results with.
schema:
type: integer
format: int32
default: 1
maximum: 550
minimum: 1
example: 1
example: 1
responses:
'200':
description: 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.
content:
application/json:
schema:
description: Response wrapper containing comprehensive competitor analysis data across both paid and organic search channels with pagination metadata.
type: object
properties:
resultCount:
description: Number of results returned
type: integer
format: int32
readOnly: true
example: 50
totalMatchingResults:
description: Total number of competitor domains available that match the query criteria, including results not included in the current page.
type: integer
format: int64
readOnly: true
example: 5000
combinedCompetitors:
description: Array of competitor domains ranked by combined SEO and PPC keyword overlap strength.
type:
- array
- 'null'
items:
type: object
properties:
rank:
description: Competitive ranking score indicating the strength of overlap between this competitor and the target domain across both SEO and PPC keywords.
type: number
format: float
example: 1
domain:
description: Domain name of the competitor that shares significant keyword overlap in both paid and organic search results.
type:
- string
- 'null'
example: example.com
additionalProperties: false
description: Represents a competitor domain that competes for similar keywords in both paid and organic search, ranked by competitive overlap strength.
readOnly: true
ppcCompetitors:
description: Array of competitor domains ranked by paid search advertising keyword overlap and competitive strength.
type:
- array
- 'null'
items:
type: object
properties:
domain:
description: Domain name of the competitor that shares significant keyword overlap in the specified search channel (SEO or PPC).
type:
- string
- 'null'
example: example.com
commonTerms:
description: Number of unique keywords that both this competitor domain and the target domain compete for in the same search channel.
type: integer
format: int32
example: 1432
rank:
description: The rank is a metric for how much overlap there is between your domain and the competitor
type: number
format: float
additionalProperties: false
description: Represents a competitor domain with shared keyword overlap data, indicating the strength of competitive relationship in either paid or organic search.
readOnly: true
seoCompetitors:
description: Array of competitor domains ranked by organic search keyword overlap and SEO competitive strength.
type:
- array
- 'null'
items:
type: object
properties:
domain:
description: Domain name of the competitor that shares significant keyword overlap in the specified search channel (SEO or PPC).
type:
- string
- 'null'
example: example.com
commonTerms:
description: Number of unique keywords that both this competitor domain and the target domain compete for in the same search channel.
type: integer
format: int32
example: 1432
rank:
description: The rank is a metric for how much overlap there is between your domain and the competitor
type: number
format: float
additionalProperties: false
description: Represents a competitor domain with shared keyword overlap data, indicating the strength of competitive relationship in either paid or organic search.
readOnly: true
additionalProperties: false
'400':
description: Bad Request - Invalid parameters provided (e.g., invalid domain format, pageSize exceeds maximum, or invalid country code)
'401':
description: Unauthorized - Invalid API credentials or insufficient permissions to access competitor data
'500':
description: Internal Server Error - A server-side error occurred while processing the request
tags:
- Competitors API
components:
securitySchemes:
Basic_Authentication_Token:
type: http
description: '<a href="https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side" target="_blank">Basic Authentication</a> is a standard that involves encoding your <code>SPYFU_API_ID:SECRET_KEY</code> into a Base64 string. Your <b>SpyFu API ID</b> and <b>Secret Key</b> can both be found under the <b><a href="https://www.spyfu.com/account/api" target="_blank">Account Settings -> API Usage</a></b> page. Additionally, you can find the Base64 string has been pre-generated on the same page under <b>Base 64 Key</b>. Finally, this encoded string is sent in the "Authorization" header prefixed with the keyword "Basic":<br>For example, to authorize as <code>00000000-0000-0000-0000-000000000000:AB12WXYZ</code> the client would send<br><pre><code>Authorization: <span class="token keyword">Basic</span> <span class="token constructor-invocation class-name">MDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDAwOkFCMTJXWFla<span></code></pre>'
scheme: basic
Query_Parameter_Token:
type: apiKey
description: An API key can be added as a query parameter. Your API key is listed as "Secret Key" found under the <b><a href="https://www.spyfu.com/account/api" target="_blank">Account Settings -> API Usage</a></b> page<br>For example, to authorize with the API key <code>AB12WXY</code><br><pre><code>/apis/example_api/GetExample?domain=spyfu.com<span class="token keyword">&api_key=AB12WXYZ</span></code></pre>
name: api_key
in: query
HMAC_Authentication_Header:
type: apiKey
description: For even more security, each request can be individually authenticated with a timestamped <a href="https://en.wikipedia.org/wiki/HMAC" target="_blank"><b>HMAC</b></a> <em>(Hash Message Authentication Code)</em> signature. Composed of your secret key, a valid timestamp, the API request path, and all request parameters. <h3>Creating the signature:</h3><br>Combine the pieces that will be converted into the signature.<br><pre><code><span class="token keyword">StringToSign</span> <span class="token operator">=</span><br>	HTTP-Verb <span class="token operator">+</span> <span class="token string">"\n"</span> <span class="token operator">+</span><br>	Timestamp <span class="token operator">+</span> <span class="token string">"\n"</span> <span class="token operator">+</span><br>	UrlPath <span class="token operator">+</span> <span class="token string">"\n"</span><br>	QueryParameters<span class="token operator">;</span><br></code></pre><br>Create UTF-8 encodings of the above string and of your secret key.<br><pre><code><span class="token keyword">byte</span><span class="token operator">[]</span> SecretKeyBytes <span class="token operator">=</span> <span class="token function">UTF-8-Encoding-Of</span><span class="token operator">(</span> Upper-Case-Of<span class="token operator">(</span> SECRET_KEY <span class="token operator">)</span> <span class="token operator">)</span><span class="token operator">;</span><br><span class="token keyword">byte</span><span class="token operator">[]</span> StringToSignBytes <span class="token operator">=</span> <span class="token function">UTF-8-Encoding-Of</span><span class="token operator">(</span> StringToSign <span class="token operator">)</span><span class="token operator">;</span><br></code></pre><br>Use an implementation of HMAC256 using your UTF-8 secret key to encode the combined string of your request. This should then be converted to Base64 to finish creating your signature.<br><pre><code><span class="token keyword">Signature</span> <span class="token operator">=</span> <span class="token function">Base64</span><span class="token operator">(</span> <span class="token function">HMAC-SHA256</span><span class="token operator">(</span> SecretKeyBytes, StringToSignBytes <span class="token operator">)</span> <span class="token operator">)</span><span class="token operator">;</span><br></code></pre><br><h3>Using the signature:</h3><br>This signature is then sent in through an Authentication header with your username.<br><pre><code>Authentication<span class="token operator">:</span> <span class="token keyword">UserName</span><span class="token operator">:</span><span class="token invocation class-name">Signature</span></code></pre>
name: Authentication
in: header