---
title: "Get keyword rankings for a Rank Radar"
method: GET
path: "/v1/niches/rank-radars/{rankRadarId}"
tags: ["v1"]
---

# Get keyword rankings for a Rank Radar

`GET /v1/niches/rank-radars/{rankRadarId}`

## Request

- Base URL: `https://api.datadive.tools`
- URL: `https://api.datadive.tools/v1/niches/rank-radars/{rankRadarId}`
- Auth: API key in header `x-api-key`

Retrieves historical keyword ranking data for the specified Rank Radar within a date range. Returns tracked keywords with their daily organic, sponsored, and impression rank positions. Use this to analyze ranking trends and performance over time. PPC and SQP keyword data are served by the dedicated `/v1/niches/rank-radars/{rankRadarId}/ppc` and `/v1/niches/rank-radars/{rankRadarId}/sqp` endpoints.

## Path parameters

- `rankRadarId` string, required

## Query parameters

- `startDate` string, required
- `endDate` string, required
- `currentPage` number
- `pageSize` number

## Response `200`

- KrtKeywordListResponseDto
  - `currentPage` number, required
  - `pageSize` number, required: Number of items per page
  - `hasNext` boolean, required: True when there is a next page. Otherwise, false
  - `hasPrev` boolean, required: True when there is a previous page. Otherwise, false
  - `lastPage` number, required: Last page or total page count
  - `total` number, required: Total number of items
  - `data` KrtKeywordResponseDto[], required: List of items
    - `id` string, required
    - `keyword` string, required
    - `searchVolume` object, required
    - `ranks` ExternalKrtAsinRankDto[], required
      - `date` string, required: Date in ISO format
      - `organicRank` object, required
      - `sponsoredRank` object, nullable, required: Sponsored (PPC) search-results rank
      - `impressionRank` object, required
    - `highlights` KrtHighlightDto[], required
      - `id` string, required: Highlight ID
      - `krtId` string, required: KRT Id related to highlight
      - `krtKeywordId` string, required: krtKeywordId related to highlight
      - `title` string, required: Title of Highlight
      - `description` object, required: Description of Highlight
      - `color` object, required: Color of Highlight
      - `type` string, required: Type of Highlight
      - `startAt` object, required: Start Date of Highlight
      - `endAt` object, required: End Date of Highlight
      - `searchVolume` number, required: Search Volume of related keywords
      - `svShare` number, required: Search Volume share of related keywords
      - `keywords` string[], required: Related keywords
    - `relevancy` object: Phrase relevancy score for this keyword within its Niche

## Other responses

- `400`: Invalid rankRadarId, date format, or a date range longer than 90 days
- `401`: Api key is invalid
- `403`: Unauthorized to access the resource
- `404`: Resource not found
- `429`: Rate limit exceeded, either the per-client-IP limit or the per-API-key limit for this endpoint.
- `500`: Internal error

## Changes

- **2026-10-01** `4a87d98ec4ca`: 1 warning
  - removed the optional property `data/items/adData` from the response with the `200` status
- **2026-09-25** `8c35e29328f7`: 10 info
  - added the new optional `query` request parameter `currentPage`
  - added the new optional `query` request parameter `pageSize`
  - added the optional property `data/items/adData` to the response with the `200` status
  - added the optional property `data/items/relevancy` to the response with the `200` status
  - …6 more
- **2026-09-18** `179bcdacf4d1`: 1 info
  - added the required property `data/items/ranks/items/sponsoredRank` to the response with the `200` status

[Operation history](https://skmtc.dev/datadive/apis/data-dive-developer-apis/changes/v1/niches/rank-radars/:rankRadarId/get.md)

---

[API](https://skmtc.dev/datadive/apis/data-dive-developer-apis.md) - [All operations](https://skmtc.dev/datadive/apis/data-dive-developer-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/datadive/apis/data-dive-developer-apis/revisions/94c025cac171?raw)