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. Set this alongside a location when targeting a place inside a country.

languageId
string | null

Language ID or null for default

locationCriteriaId
number | null

Google Ads location criteria ID for local (sub-country) tracking - city, county, state, region or neighbourhood. Get it from search_locations; never guess it. Omit/null for country-only tracking.

locationCanonicalName
string | null

Canonical location name from the same search_locations row (e.g. "Palm Beach County,Florida,United States"). Send it whenever locationCriteriaId is set; if omitted the stored canonical name is null.

items
object[]

Batch of keywords to track

active
boolean

Defaults to true. Set false to add the keywords to the team's list WITHOUT tracking them: no SERP allowance is consumed and no crawl is scheduled, and they can be tracked later. Batch (items) only.

Response

Default Response

success
boolean
requested
number
alreadyTracked
number
reactivated
number
created
number