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

# Archive search terms of a Rank Radar

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

## Request

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

Archives (pauses) the specified search terms of a Rank Radar so they stop being tracked and their Daily Tracked Keywords quota is freed. Search terms are identified by their Rank Radar keyword identifiers (the `id` values returned by GET /v1/niches/rank-radars/:rankRadarId and the `keywordToRankRadarKeywordIdMap` values returned by the add search terms endpoint). This operation is idempotent: search terms that are already archived are left unchanged.

## Path parameters

- `rankRadarId` string, required

## Request body

- RankRadarSearchTermIdsDto
  - `rankRadarKeywordIds` string[], required: The Rank Radar keyword identifiers to update. These are the `id` values returned by GET /v1/niches/rank-radars/:rankRadarId and the `keywordToRankRadarKeywordIdMap` values returned by the add search terms endpoint.

## Response `204`

Archived

## Other responses

- `400`: Invalid rankRadarId or rankRadarKeywordIds
- `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, either the per-client-IP limit or the per-API-key limit for this endpoint.
- `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.dev/datadive/apis/data-dive-developer-apis/revisions/94c025cac171?raw)