---
title: "Add search terms to a Rank Radar"
method: POST
path: "/v1/niches/rank-radars/{rankRadarId}/search-terms"
tags: ["v1"]
---

# Add search terms to a Rank Radar

`POST /v1/niches/rank-radars/{rankRadarId}/search-terms`

## Request

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

Adds manual search terms (keywords) to an existing Rank Radar for tracking. New keywords are added to the Niche and start being tracked, while any previously paused matching keywords are resumed. Daily Tracked Keywords quota is consumed for each newly tracked keyword. Returns the origin breakdown of the submitted terms and `keywordToRankRadarKeywordIdMap`, mapping each term to its Rank Radar keyword identifier.

## Path parameters

- `rankRadarId` string, required

## Request body

- AddSearchTermsRequestDto

## Response `200`

- ExternalAddSearchTermsResponseDto
  - `originBreakdown` object, required
  - `keywordToRankRadarKeywordIdMap` object, required

## Other responses

- `400`: Invalid rankRadarId, invalid search terms, or Daily Tracked Keywords quota exceeded (`error: "QUOTA_EXCEEDED"`)
- `401`: Api key is invalid
- `403`: Rank Radar does not belong to this subscription, or the member who authorized this connection no longer has access to the organization
- `404`: Rank Radar not found
- `429`: Rate limit exceeded (2 requests/min per API key).
- `500`: Internal error

## Changes

- **2026-09-15** `83202c6c6458`: 1 warning
  - added the new `REVIEW_REQUEST_ASINS` enum value to the `feature` response property for the response status `400`
- **2026-09-08** `0e41255f2949`: 1 info
  - added the media type `application/json` for the response with the status `400`

[Operation history](https://skmtc.dev/datadive/apis/data-dive-developer-apis/changes/v1/niches/rank-radars/:rankRadarId/search-terms/post.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)