v1

latestOpenAPI 3.1.02026-07-24490622.0 KB
Ranking History API

Get Domain Keyword Rankings

Returns historical organic ranking data for a specific domain across multiple specified keywords within a date range. Analyze how a domain's positions have changed over time for your target keyword list.

Visualize this API live on SpyFu (TODO – verify)

get/v2/historic/getHistoricRankingsForDomainOnKeywords

Query parameters

domainstring required
Example:example.com

Domain to analyze ranking history for.

keywordsstring required
Example:best running shoes,nike shoes,athletic footwear

Comma-separated list of keywords to analyze rankings for.

startDatestring date-time
Example:2025-01

Beginning date for range

endDatestring date-time
Example:2025-07

Ending date for range

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 to get results for.

Response

Successfully retrieved domain ranking history for specified keywords

resultCountinteger

Number of results returned

Example response

{
  "resultCount": 100
}