v1
latestOpenAPI 3.1.02026-07-24490622.0 KBRanking History API
Get Keyword Domain Rankings
Returns historical organic ranking data for a specific keyword across multiple specified domains within a date range. Compare how different domains have performed for the same keyword over time.
Visualize this API live on SpyFu (TODO – verify)
get/v2/historic/getHistoricRankingsForKeywordOnDomains
Query parameters
keywordstring required
Example:best running shoes
Keyword to analyze ranking history for.
domainsstring required
Example:example.com,competitor1.com,competitor2.com
Comma-separated list of domains to compare 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 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>
Response
Successfully retrieved keyword ranking history across specified domains
Example response
{
"resultCount": 100
}