Sign in
latestOpenAPI 3.0.02026-08-215090368.2 KB

c8f1f876a92c

Topic Clusters

Add keyword to topic cluster

Links a keyword to a topic cluster, optionally tracking it for rank monitoring.

post/v3/topic-clusters/{topicId}/keywords

Path parameters

topicIdstring required

Topic cluster ID

Request body

teamIdstring

Team ID

keywordstring

Keyword text to add

countryIdstring nullable
languageIdstring nullable
locationCriteriaIdnumber nullable

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

locationCanonicalNamestring nullable

Canonical location name paired with locationCriteriaId.

trackboolean

Whether to also track this keyword for rank monitoring

Response

Default Response

successboolean
keywordIdstring
countryIdstring nullable
languageIdstring nullable
locationCriteriaIdnumber nullable
locationCanonicalNamestring nullable
requestednumber
addednumber
alreadyHerenumber
skippednumber
keywordsNotTrackednumber