Find domains historic rankings for a date range

get

https://api.spyfu.com/apis/organic_history_api/v2/historic/getHistoricRankingsForDomain

Find domains historic rankings for a date range.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

domain

string

required

Domain to analyze ranking history for.

queryType

string

enum

Type of ranking analysis to perform.

startDate

date-time

Beginning date for range

endDate

date-time

Ending date for range

includeTerms

string

Comma-separated list of terms that must be present in the keyword.

includeAnyTerm

boolean

Defaults to false

Used with includeTerms. If true: match any term (OR). If false: require all terms (AND).

excludeTerms

string

Comma-separated list of terms to exclude from results (e.g., branded or irrelevant terms).

startRank.min

float

Filter to keywords where the domain/URL starting rank position is ≥ this value for the selected date range (1 = best/top organic result).

startRank.max

float

Filter to keywords where the domain/URL starting rank position is ≤ this value for the selected date range (1 = best/top organic result).

endRank.min

float

Filter to keywords where the domain/URL ending rank position is ≥ this value for the selected date range (1 = best/top organic result).

endRank.max

float

Filter to keywords where the domain/URL ending rank position is ≤ this value for the selected date range (1 = best/top organic result).

endRankChange.min

float

Filter to keywords where the rank improved by at least this many positions between the start and end of the date range (end_rank_change ≥ value). Positive values mean moved up; negative values mean moved down.

endRankChange.max

float

Filter to keywords where the rank change was at most this many positions between the start and end of the date range (end_rank_change ≤ value). Positive values mean moved up; negative values mean moved down.

seoClicks.min

float

Filter to keywords where estimated monthly organic clicks (SEO clicks) to the domain/url are ≥ this value.

seoClicks.max

float

Filter to keywords where estimated monthly organic clicks (SEO clicks) to the domain/url are ≤ this value.

seoClicksChange.min

float

Filter to keywords where the month-over-month change in estimated organic clicks is ≥ this value. Positive values indicate click gains; negative values indicate click losses.

seoClicksChange.max

float

Filter to keywords where the month-over-month change in estimated organic clicks is ≤ this value. Positive values indicate click gains; negative values indicate click losses.

searchVolume.min

float

Filter to keywords where monthly search volume (Google) is ≥ this value.

searchVolume.max

float

Filter to keywords where monthly search volume (Google) is ≤ this value.

countryCode

string

enum

Defaults to 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.). All Countries

sortBy

string

enum

Field to sort by

Allowed:

pageSize

int32

1 to 10000

Defaults to 5

The maximum number of rows returned.

startingRow

int32

1 to 10000

Defaults to 1

Row number to start the results with.

sortOrder

string

enum

Order to sort by

Allowed:

Responses

400

Invalid request parameters or date range

401

User failed authorization

500

Server error while processing ranking history data

200Successfully retrieved domain ranking history data