v1

Get Search Query Performance data for a Rank Radar

Changed on

Retrieves aggregated Search Query Performance (SQP) data per tracked keyword for the specified Rank Radar within a date range — impressions, clicks, cart adds, and purchases (total and for this ASIN family), CTR/CVR, and Amazon's search query score/volume. Rate limited to approximately 60 requests per minute per API key.

get/v1/niches/rank-radars/{rankRadarId}/sqp

Request

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

Path parameters

rankRadarIdstring required

The unique identifier of the Rank Radar

Query parameters

startDatestring required
Example:2024-03-01

Start date for the SQP data range in yyyy-mm-dd format. The range can span at most 90 days

endDatestring required
Example:2024-03-26

End date for the SQP data range in yyyy-mm-dd format. The range can span at most 90 days

currentPagenumber
Example:1

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

pageSizenumber
Example:20

Number of keywords per page. By default, it is 20. Max page size is 100

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,
  "data": [
    {
      "keyword": "keyword"
    }
  ]
}

Changes

    • breaking

      the response's body type changed from array to object for status

    • info

      added the new optional query request parameter currentPage

    • info

      added the new optional query request parameter pageSize

    7 more changes in this revision