---
title: "Create a new Niche Dive"
method: POST
path: "/v1/niches/dives"
tags: ["v1"]
---

# Create a new Niche Dive

`POST /v1/niches/dives`

Initiates a Niche Dive starting from a hero ASIN. The Niche Dive process automatically identifies and analyzes Competitors, extracts relevant keywords, and generates complete Niche research data. Dive tokens are consumed based on the number of Competitors specified. Returns a diveId to track the analysis progress.

## Request body

- CreateNicheDiveRequestDto
  - `marketplace` 'com' | 'ca' | 'co.uk' | 'com.mx' | 'in' | 'fr' | 'de' | 'es' | 'it' | 'co.jp', required — The Amazon marketplace where the seed product is listed
  - `asin` string, required — The seed ASIN to start the Niche Dive analysis from. The system will identify related Competitors and build the Niche around this product.
  - `numberOfCompetitors` number, required — Number of Competitors to include in the Niche analysis. More Competitors provide deeper insights but consume more Dive tokens. Minimum is 2.

## Response `200`

- CreateNicheDiveSuccessResponseDto
  - `diveId` string, required — Unique identifier for the Dive. Use this ID to check the Dive status and retrieve results when complete.
  - `estimatedCompletionDate` string, required — Estimated completion timestamp for the Niche Dive analysis in ISO 8601 format

## 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)