SPspyfu
Ranking 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

Request

  • Base URL
    https://api.spyfu.com/apis/organic_history_api
  • URL
    https://api.spyfu.com/apis/organic_history_api/v2/historic/getHistoricRankingsForKeywordOnDomains
  • Auth
    • HTTP basic
    • or API key in query parameter api_key
    • or API key in header Authentication

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

resultCountinteger

Number of results returned

Example response

{
  "resultCount": 100
}

Changes

No recorded changes to this operation across all 1 revision of this API.