---
title: "Create a new Niche Dive from an explicit Competitor list"
method: POST
path: "/v1/niches/dive_with_competitors"
tags: ["v1"]
---

# Create a new Niche Dive from an explicit Competitor list

`POST /v1/niches/dive_with_competitors`

Initiates a Niche Dive from a caller-provided list of Competitor ASINs — no automatic Competitor discovery is performed. Mirrors the "ASIN tray → Create Niche" flow in the extension. Dive tokens are consumed based on the number of ASINs supplied. Returns a diveId to track the analysis progress via GET /v1/niches/dives/{diveId}.

## Request body

- CreateNicheDiveWithCompetitorsRequestDto
  - `marketplace` 'com' | 'ca' | 'co.uk' | 'com.mx' | 'in' | 'fr' | 'de' | 'es' | 'it' | 'co.jp', required — The Amazon marketplace where the given ASINs are listed
  - `asins` string[], required — The explicit list of Competitor ASINs to build the Niche from. No automatic Competitor discovery is performed — the Niche Dive runs on exactly these ASINs. Dive tokens are consumed for each one.

## Response `200`

- CreateNicheDiveWithCompetitorsResponseDto
  - `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` — The number of ASINs exceeds your plan limit, or you are at your Niche limit
- `404` — Resource not found
- `422` — Current product data could not be found for enough of the given ASINs. No Dive tokens are consumed.
- `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)