Skip to main content
POST
Add one or more tracked keywords
Start tracking a new keyword for your team.

Authorizations

Authorization
string
header
required

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

Body

application/json
teamId
string

Team ID

keyword
string

Keyword to track

Required string length: 1 - 255
countryId
string | null

Country ID (ISO2) or null for worldwide

languageId
string | null

Language ID or null for default

locationCriteriaId
number | null

Google Ads location criteria ID for city/region-level tracking (from canonicalcities). Omit/null for country-only.

locationCanonicalName
string | null

Canonical location name (e.g. "Austin,Texas,United States"). Should be sent whenever locationCriteriaId is set; if omitted the stored canonical name is null.

items
object[]

Batch of keywords to track

Response

Default Response

success
boolean
requested
number
alreadyTracked
number
reactivated
number
created
number