Create a new Niche Dive from an explicit Competitor list

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}.

post/v1/niches/dive_with_competitors

Request

Base URL
https://api.datadive.tools
URL
https://api.datadive.tools/v1/niches/dive_with_competitors
Auth
API key in header x-api-key

Request body

marketplace'com' | 'ca' | 'co.uk' | 'com.mx' | 'in' | 'fr' | 'de' | 'es' | 'it' | 'co.jp' required

The Amazon marketplace where the given ASINs are listed

asinsstring[] 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.

Example request

{
  "marketplace": "com",
  "asins": [
    "B08N5WRWNW",
    "B09617YV4C"
  ]
}

Response

diveIdstring required

Unique identifier for the Dive. Use this ID to check the Dive status and retrieve results when complete.

estimatedCompletionDatestring required

Estimated completion timestamp for the Niche Dive analysis in ISO 8601 format

Example response

{
  "diveId": "b3e1f2c4-7e6a-4d2a-9f1e-123456789abc",
  "estimatedCompletionDate": "2024-04-01T00:00:00Z"
}

Changes

No recorded changes to this operation across all 19 revisions of this API.