DAdatadive
v1

Get keyword rankings for a Rank Radar

Changed on

Retrieves historical keyword ranking data for the specified Rank Radar within a date range. Returns tracked keywords with their daily organic, sponsored, and impression rank positions. Use this to analyze ranking trends and performance over time. PPC and SQP keyword data are served by the dedicated /v1/niches/rank-radars/{rankRadarId}/ppc and /v1/niches/rank-radars/{rankRadarId}/sqp endpoints.

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

Request

  • Base URL
    https://api.datadive.tools
  • URL
    https://api.datadive.tools/v1/niches/rank-radars/{rankRadarId}
  • 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 ranking 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 ranking 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

  • 4a87d98ec4caRevision changes
    • warning

      removed the optional property // from the response with the status

  • 8c35e29328f7Revision changes
    • info

      added the new optional query request parameter currentPage

    • info

      added the new optional query request parameter pageSize

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status