DAdatadive
v1

List all Rank Radars

Changed on

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

Request

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

Query parameters

nicheIdstring

Filter Rank Radars by Niche identifier

spacesnumber[]

Only items in at least one of these Spaces (ids from GET /v1/spaces). Repeat the parameter or use spaces[]=1&spaces[]=2. At most 100. Combines with labels and the other filters with AND.

[
  12,
  34
]
labelsnumber[]

Only items with at least one of these labels (ids from GET /v1/labels). Repeat the parameter or use labels[]=1&labels[]=2. At most 100. Combines with spaces and the other filters with AND.

[
  12,
  34
]
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.

pageSizeunknown
Example:20

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

currentPageunknown
Example:1

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

searchTextunknown

Filter Rank Radars by ASIN or product title. An exact, case-insensitive ASIN match against any ASIN of the tracked variation family, so a variation finds the Rank Radar that tracks its family; otherwise a substring match on the 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

  • 838b9910d190Revision changes
    • info

      added the new optional query request parameter labels

    • info

      added the new optional query request parameter spaces