Skip to main content
GET
List tracked keywords
Get a list of every keyword you’re tracking for a team, along with its current search position, previous position, and whether it’s improving or declining.

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) for GSC position summary window.

endDate
string

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

days
integer

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

includeInactive
boolean

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

fields
enum<string>

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. Omit for the full response.

Available options:
minimal

Response

Default Response

items
object[]
required