DAdatadive
v1

Create a new Niche Dive

Changed on

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

  • Base URL
    https://api.datadive.tools
  • URL
    https://api.datadive.tools/v1/niches/dives
  • 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 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.

fastKeywordsRequestIdnumber required

Links the Niche Dive to a Fast Keywords run. Pass the requestId returned by POST /v1/fast-keywords or POST /v1/fast-keywords/{fastKeywordsId}/refresh, not the fastKeywordsId. An id that is not yours is ignored.

Example request

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

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