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

# Get Domain Keyword Rankings

`GET /v2/historic/getHistoricRankingsForDomainOnKeywords`

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](https://www.spyfu.com/seo/ranking-history/domain?expandChart=false&searchType=MostValuable&includeAnyTerm=true&query=example.com&sidebarContext=topics) _(TODO – verify)_

## Query parameters

- `domain` string, required
- `keywords` 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 domain ranking history for specified keywords

- 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, domain, or keyword 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)