List all Rank Radars

Retrieves a paginated list of Rank Radars. Rank Radars track keyword rankings over time for specific ASINs, monitoring organic and sponsored positions across search results. Returns summary metrics including top 10/50 keyword counts and search volumes. By default only active Rank Radars are returned; use the status filter for paused or archived ones.

get/v1/niches/rank-radars

Query parameters

nicheIdstring

Filter Rank Radars by Niche identifier

status'ACTIVE' | 'PAUSED' | 'ARCHIVED' | 'ALL'

Filter by Rank Radar status. ACTIVE (the default) returns Rank Radars that are tracking; PAUSED returns those stopped via the archive endpoint; ARCHIVED returns those removed via DELETE; ALL returns active and paused together. Any other value is rejected with 400.

{"stackTrail":"paths:/v1/niches/rank-radars:get:parameters:2:schema","oasType":"schema","type":"unknown","example":20}

Number of items per page. By default, it is 20. Max page size is 50

{"stackTrail":"paths:/v1/niches/rank-radars:get:parameters:3:schema","oasType":"schema","type":"unknown","example":1}

The page of items to retrieve. By default, it is 1

{"stackTrail":"paths:/v1/niches/rank-radars:get:parameters:4:schema","oasType":"schema","type":"unknown"}

Filter Rank Radars by ASIN or product title

Response

currentPagenumber required

pageSizenumber required

Number of items per page

hasNextboolean required

True when there is a next page. Otherwise, false

hasPrevboolean required

True when there is a previous page. Otherwise, false

lastPagenumber required

Last page or total page count

totalnumber required

Total number of items

Example response

{
  "currentPage": 1,
  "pageSize": 20,
  "lastPage": 1,
  "total": 1
}

Changes

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