Skip to main content
POST
Add keyword to topic cluster
Add a keyword to an existing topic cluster. If the keyword doesn’t exist yet, it will be created automatically. Keyword metrics (volume, competition) are fetched in the background.

Authorizations

Authorization
string
header
required

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

Path Parameters

topicId
string
required

Topic cluster ID

Body

application/json
teamId
string

Team ID

keyword
string

Keyword text to add

countryId
string | null
languageId
string | null
locationCriteriaId
number | null

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

locationCanonicalName
string | null

Canonical location name paired with locationCriteriaId.

items
object[]

Bulk mode: one item per keyword. Items already linked to another topic are skipped.

track
boolean

Whether to also track this keyword for rank monitoring

Response

Default Response

success
boolean
keywordId
string
countryId
string | null
languageId
string | null
locationCriteriaId
number | null
locationCanonicalName
string | null
requested
number
added
number
alreadyHere
number
skipped
number