Sign in
Rank Tracking

List tracked keywords

Returns the list of tracked keywords for a team.

get/v3/rank-tracking/keywords

Query parameters

teamIdstring

Team ID

startDatestring

Start date (YYYY-MM-DD, UTC) for GSC position summary window.

endDatestring

End date (YYYY-MM-DD, UTC) for GSC position summary window.

daysinteger

Days to look back for GSC position summary (legacy fallback).

includeInactiveboolean

When true, also returns soft-untracked (active=false) keywords so the UI can offer re-tracking. Defaults to false (active only).

fields'minimal' | 'summary'

Set to 'minimal' for a trimmed payload (keyword text + targeting + tracked flags only, no positionHistory/resultHistory). Intended for callers that only check whether a keyword is tracked. Set to 'summary' for everything except resultHistory and the Search Console columns (gscPosition, gscClicks and gscImpressions are null) - keeps positionHistory, so callers that plot a rank trend but never open a SERP snapshot skip the largest part of the payload. Omit for the full response.

sort'position'

Set to 'position' for best rank first, unranked keywords last. Omit for tracked-first, most recently updated order.

pageinteger

1-based page. Default 1.

pageSizestring

Rows per page, or 'all'. Every response reports total and totalPages.

Response

Default Response

pageinteger
pageSizeinteger
totalinteger
totalPagesinteger

Changes

Changed in 5 of the 47 revisions of this API.16

  • 623d4784f6e67See the full diff
    • ○

      added the new optional query request parameter page

      new-optional-request-parameter

    • ○

      added the new optional query request parameter pageSize

      new-optional-request-parameter

    • ○

      added the new optional query request parameter sort

      new-optional-request-parameter

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • ea8bce67cd7e6See the full diff
    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

    • ○

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

      response-optional-property-added

  • 86840800b2f31See the full diff
    • ○

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

      response-optional-property-added

  • 18b0da2d36961See the full diff
    • ○

      added the new enum value summary to the query request parameter fields

      request-parameter-enum-value-added

  • 03816a1502141See the full diff
    • ○

      added the new optional query request parameter fields

      new-optional-request-parameter