Sign in
Rank Tracking

Top keywords from GSC

Returns the top performing keywords from Google Search Console for a team.

get/v3/rank-tracking/top-keywords

Query parameters

teamIdstring

Team ID

startDatestring

Start date (YYYY-MM-DD, UTC). Preferred over days.

endDatestring

End date (YYYY-MM-DD, UTC). Preferred over days.

daysinteger

Number of days to look back (legacy fallback)

devicestring

Device filter

typestring

Search type filter

countrystring

Country filter

scope'all' | 'ranked' | 'tracked'

Keyword universe: all (GSC + tracked merged), ranked (GSC only), tracked (tracked only). Defaults to all.

limitinteger

Max results

includeComparisonstring

Include period-over-period comparison

includePagesstring

Embed each keyword's ranking page URLs (two extra Search Console queries plus every stored SERP page). Defaults to true; pass false when only the keyword rows are rendered.

currentPeriodDaysinteger

Days in current period (legacy fallback)

previousPeriodDaysinteger

Days in previous period (legacy fallback)

Response

Default Response

Changes

Changed in 2 of the 47 revisions of this API.11

  • 623d4784f6e61See the full diff
    • ○

      added the new optional query request parameter includePages

      new-optional-request-parameter

  • 60ff6690f93c1See the full diff
    • ●

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

      response-optional-property-removed