---
title: "Get Keyword Domain Rankings"
method: GET
path: "/v2/historic/getHistoricRankingsForKeywordOnDomains"
tags: ["Ranking History API"]
---

# Get Keyword Domain Rankings

`GET /v2/historic/getHistoricRankingsForKeywordOnDomains`

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](https://www.spyfu.com/keyword/ranking-history?query=example%20keyword) _(TODO – verify)_

## Query parameters

- `keyword` string, required
- `domains` string, required
- `startDate` string, date-time
- `endDate` string, date-time
- `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'

## Response `200`

Successfully retrieved keyword ranking history across specified domains

- object
  - `resultCount` integer — Number of results returned
  - `results` object[], nullable
    - `domain` string, nullable
    - `keyword` string, nullable
    - `results` object, nullable

## Other responses

- `400` — Invalid request parameters, keyword, or domain list
- `401` — User failed authorization
- `500` — Server error while processing ranking history data

---

[API](https://skmtc.net/spyfu/apis/domain-stats-api.md) · [All operations](https://skmtc.net/spyfu/apis/domain-stats-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spyfu/domain-stats-api/revisions/44f0aff08ed0/schema)