SpyFu
New RivalFlow AI

Improve Existing Content with AI

RivalFlow spots gaps in your existing SEO content and generates high-ranking content to fill them.

Documentation Powered by ReDoc

Competitor Url Analysis API Documentation (v1)

Search for a url, or any part of a url - host, path, page - and get every keyword it ranks on. Also, get core stats like clicks and budget.

Authentication

Authentication

Basic Auth Token

Security scheme type: HTTP
HTTP Authorization Scheme basic

api_key

Secret Key Authentication

Security scheme type: API Key
Query parameter name: api_key

UrlApi

Search for a URL and get back all the keywords that URL ranks on. In addition, we add in as many relevant stats on those keywords as we can.

Get paid data from url

get /paid_kws
https://www.spyfu.com:80/apis/url_api/paid_kws
query Parameters
q
required
string

Url query

r
required
integer <int32>

Maximum number of rows

t
string

Filterable term

p
string

Position range: [Min# to Max#]

eldsv
string

Exact local daily search volume range: [Min# to Max#]

egdsv
string

Exact global daily search volume range: [Min# to Max#]

ecpc
string

Exact cost per click range: [Min# to Max#]

eclpd
string

Exact clicks per day range: [Min# to Max#]

ecopd
string

Exact cost per day range: [Min# to Max#]

msd
string

Max search date: YYYYMMDD

api_key
string

User's secret key

Responses

200

OK

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/url_api/paid_kws?q=http://www.spyfu.com&r=10&api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    • "term": "keyword research",
    • "position": 2,
    • "exact_local_daily_search_volume": 146,
    • "exact_global_daily_search_volume": 493,
    • "full_url": "spyfu.com",
    • "broad_cost_per_click": 5.2,
    • "phrase_cost_per_click": 6.48,
    • "exact_cost_per_click": 5.73,
    • "broad_clicks_per_day": 79.77,
    • "phrase_clicks_per_day": 7.69,
    • "exact_clicks_per_day": 1.71,
    • "broad_cost_per_day": 414.77,
    • "phrase_cost_per_day": 49.84,
    • "exact_cost_per_day": 9.78,
    • "max_search_date_id": "20170201",
    • "weighting_rank": 2,
    • "ad_history_overview": "410087777576",
    • "advertisers": 6
    }
]

Get organic data from url

get /organic_kws
https://www.spyfu.com:80/apis/url_api/organic_kws
query Parameters
q
required
string

Url query

r
required
integer <int32>

Maximum number of rows

t
string

Filterable term

p
string

Position range: [Min# to Max#]

elmsv
string

Exact local monthly search volume range: [Min# to Max#]

egmsv
string

Exact global monthly search volume range: [Min# to Max#]

ecpc
string

Exact cost per click range: [Min# to Max#]

mc
string

Monthly clicks range: [Min# to Max#]

sd
string

SEO difficulty range: [Min# to Max#]

pc
string

Position Change range: [Min# to Max#]

api_key
string

User's secret key

Responses

200

OK

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/url_api/organic_kws?q=http://www.spyfu.com&r=10&api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
[
  • {
    • "term": "spyfu com",
    • "position": 1,
    • "exact_local_monthly_search_volume": 570,
    • "exact_global_monthly_search_volume": 870,
    • "max_organic_clicks_per_day": 3.12,
    • "full_url": "spyfu.com",
    • "broad_cost_per_click": 0.06,
    • "phrase_cost_per_click": 0.02,
    • "exact_cost_per_click": 44.37,
    • "monthly_clicks": 93.48,
    • "seo_difficulty": 61,
    • "url_position_change": 0,
    • "previous_position": 1,
    • "value_per_month": 4147.7076
    }
]

Get paid estimates from url

get /paid_estimates
https://www.spyfu.com:80/apis/url_api/paid_estimates
query Parameters
q
required
string

Url query

r
integer <int32>

Maximum number of rows

api_key
string

User's secret key

Responses

200

OK

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/url_api/paid_estimates?q=http://www.spyfu.com&api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "ppc_value_estimate": 12629.8995,
  • "ppc_clicks_estimate": 5446.8641590875895,
  • "ppc_num_results": 4721
}

Get organic estimates from url

get /organic_estimates
https://www.spyfu.com:80/apis/url_api/organic_estimates
query Parameters
q
required
string

Url query

r
integer <int32>

Maximum number of rows

api_key
string

User's secret key

Responses

200

OK

500

InternalServerError

Request samples

Copy
curl "https://www.spyfu.com/apis/url_api/organic_estimates?q=http://www.spyfu.com&api_key=SECRET_KEY"

Response samples

Content type
application/json
Copy
 Expand all Collapse all
{
  • "seo_value_estimate": 694378.6523123268,
  • "seo_traffic_estimate": 2689784.3837209768,
  • "seo_num_results": 12077
}