---
title: "Create a new Rank Radar"
method: POST
path: "/v1/niches/rank-radars"
tags: ["v1"]
---

# Create a new Rank Radar

`POST /v1/niches/rank-radars`

Creates a new Rank Radar to track keyword rankings for a specific ASIN within a Niche. The Rank Radar will monitor organic and sponsored rankings for the specified number of keywords. Rank Radar Search Term tokens are consumed based on the number of keywords tracked. Returns a rankRadarId for accessing the tracking data.

## Request body

- CreateRankRadarRequestDto
  - `asin` string, required — The ASIN of the product to track keyword rankings for
  - `numberOfKeywords` number, required — Number of keywords to track in the Rank Radar. More keywords provide comprehensive tracking but consume more Search Term tokens. Minimum is 1.
  - `nicheId` string, required — The Niche identifier that this Rank Radar is associated with

## Response `200`

- CreateRankRadarSuccessResponseDto
  - `rankRadarId` string, required — Unique identifier for the created Rank Radar. Use this ID to retrieve keyword ranking data and track performance over time.

## Other responses

- `400`
- `401` — Api key is invalid
- `403` — Unauthorized to access the resource
- `404` — Resource not found
- `429` — Rate limit exceeded (2 requests/min per API key).
- `500` — Internal error

---

[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-service-production.skmtc.workers.dev/v1/apis/datadive/data-dive-developer-apis/revisions/03207abc96ba/schema)