---
title: "Get a Niche's keyword exclusions"
method: GET
path: "/v1/niches/{nicheId}/keyword-exclusions"
tags: ["v1"]
---

# Get a Niche's keyword exclusions

`GET /v1/niches/{nicheId}/keyword-exclusions`

## Request

- Base URL: `https://api.datadive.tools`
- URL: `https://api.datadive.tools/v1/niches/{nicheId}/keyword-exclusions`
- Auth: API key in header `x-api-key`

Lists the keywords excluded from a Niche's Master Keyword List, the same list the web app shows:

- `exact` — each hides the one keyword that matches it exactly.
- `phrase` — each hides every keyword containing the phrase, with how many keywords and how much search volume it hides.

Change them with POST /v1/niches/{nicheId}/keyword-exclusions and POST /v1/niches/{nicheId}/keyword-exclusions/remove.

## Path parameters

- `nicheId` string, required

## Response `200`

- object
  - `message` string
  - `data` object
    - `exact` ExactKeywordExclusionDto[], required: Exact exclusions, oldest first.
      - `keyword` string, required
      - `searchVolume` number, required: Search volume of the excluded keyword. 0 when the Niche has no such keyword.
    - `phrase` PhraseKeywordExclusionDto[], required: Phrase exclusions, oldest first.
      - `phrase` string, required
      - `searchVolume` number, required: Total search volume of the keywords this phrase hides, besides those already excluded exactly.
      - `excludedKeywordsCount` number, required: Number of keywords this phrase hides.

## Other responses

- `400`: Invalid nicheId
- `401`: Api key is invalid
- `403`: The Niche belongs to another subscription
- `404`: Niche not found, or it has no completed research
- `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-13** `8ce2cc36c41a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/datadive/apis/data-dive-developer-apis/changes/v1/niches/:nicheId/keyword-exclusions/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)