Sign in
v1

Re-dive an existing Niche

Re-runs a Dive on an existing Niche to refresh its research data. Two modes:

  • same_competitors — re-dives the Niche's current Competitor set. Takes no other field.
  • discover — searches for a fresh Competitor set, keeping any lockedAsins and skipping any excludedAsins. numberOfCompetitors is the total number of ASINs the refreshed Dive should contain, including the locked ones. heroAsin is the seed product discovery starts from; when omitted it defaults to the Niche Competitor with the highest sales, preferring one that belongs to one of your connected seller accounts.

The Dive runs asynchronously and consumes Dive tokens like any other Dive. Poll GET /v1/niches/dives/{diveId} with the returned diveId until the status is success or error. The refreshed data stays on the same nicheId; no new Niche is created.

post/v1/niches/{nicheId}/redive

Path parameters

nicheIdstring required

The unique identifier of the Niche to re-dive

Request body

mode'same_competitors' | 'discover' required

How to pick the Competitors for the refreshed Dive. same_competitors re-dives the Niche's current Competitor set and takes no other field. discover searches for a fresh Competitor set.

numberOfCompetitorsinteger

Total number of ASINs the refreshed Dive should contain, including lockedAsins. Required in discover mode and rejected in same_competitors mode. Dive tokens are consumed for each ASIN.

heroAsinstring

Seed product the Competitor discovery starts from. Defaults to the Niche Competitor with the highest sales, preferring one that belongs to one of your connected seller accounts. discover mode only.

lockedAsinsstring[]

ASINs that must be kept in the refreshed Competitor set regardless of what discovery finds. discover mode only.

excludedAsinsstring[]

ASINs that discovery must never select. discover mode only.

Example request

{
  "mode": "discover",
  "numberOfCompetitors": 12,
  "heroAsin": "B08N5WRWNW",
  "lockedAsins": [
    "B08N5WRWNW",
    "B09617YV4C"
  ],
  "excludedAsins": [
    "B07XHRSRZ2"
  ]
}

Response

messagestring

Example response

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

Changes

No recorded changes to this endpoint across all 1 revision of this API.