Sign in
v1

Create a new Niche Dive

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.

post/v1/niches/dives

Request body

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

The Amazon marketplace where the seed product is listed

asinstring required

The seed ASIN to start the Niche Dive analysis from. The system will identify related Competitors and build the Niche around this product.

numberOfCompetitorsnumber required

Number of Competitors to include in the Niche analysis. More Competitors provide deeper insights but consume more Dive tokens. Minimum is 2.

Example request

{
  "marketplace": "com",
  "asin": "B08N5WRWNW",
  "numberOfCompetitors": 5
}

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 endpoint across all 1 revision of this API.