Skip to main content
GET
Top keywords from GSC
Get your top-performing keywords sorted by their current search position. Useful for spotting which keywords are driving the most visibility.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

teamId
string

Team ID

startDate
string

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

endDate
string

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

days
integer

Number of days to look back (legacy fallback)

device
string

Device filter

type
string

Search type filter

country
string

Country filter

scope
enum<string>

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

Available options:
all,
ranked,
tracked
limit
integer

Max results

includeComparison
string

Include period-over-period comparison

currentPeriodDays
integer

Days in current period (legacy fallback)

previousPeriodDays
integer

Days in previous period (legacy fallback)

Response

Default Response

items
object[]