---
title: "Get the outlier keywords of a niche"
method: GET
path: "/v1/niches/{nicheId}/outlier_keywords"
tags: ["v1"]
---

# Get the outlier keywords of a niche

`GET /v1/niches/{nicheId}/outlier_keywords`

## Request

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

High search volume keywords that only a few of the niche competitors rank for, so they fall outside the master keyword list. Paginated: walk the pages with currentPage until hasNext is false.

## Path parameters

- `nicheId` string, required

## Query parameters

- `currentPage` number
- `pageSize` number

## Response `200`

- object
  - `message` string
  - `data` object
    - `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` MasterKeyword[], required: List of items
      - `keyword` string, required: The search term or keyword phrase
      - `searchVolume` number, required: Monthly search volume for this keyword on Amazon
      - `relevancy` object, required: Relevancy score indicating how well the keyword matches the Niche. Can be "Outlier" or a numeric score.
      - `asinRanks` object, required: Competitor ASINs organic ranks for this keyword. Null indicates the product is not ranked in the first pages.
      - `suggestedBid` BidInfo, required
        - `min` number, required: Min bid. For USD, the value is in cent. For example: 101 means $1.01
        - `max` number, required: Max bid. For USD, the value is in cent. For example: 886 means $8.86
        - `median` number, required: Average bid. For USD, the value is in cent. For example: 445 means $4.45
    - `latestResearchDate` string, date-time, required: The date when the Niche was last researched

## Other responses

- `400`: Invalid nicheId
- `401`: Api key is invalid
- `403`: Unauthorized to access the resource
- `404`: Resource not found
- `429`: Rate limit exceeded (60 requests/min per organization and Niche).
- `500`: Internal error

## Changes

- **2026-10-09** `5e7bd3b4011b`: 1 info
  - endpoint added

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