Skip to main content
POST
/
topic-clusters
/
{topicId}
/
keywords
Topic Keywords
curl --request POST \
  --url https://v3-api-beta.snowseo.com/snowseo/v2/topic-clusters/{topicId}/keywords \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "teamId": "<string>",
  "keyword": "<string>",
  "countryId": "<string>",
  "languageId": "<string>"
}
'
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.

​
Request

​
topicId
string
required
The ID of the topic cluster.
​
teamId
string
required
Your team ID.
​
keyword
string
required
The keyword to link to this topic (e.g., technical seo checklist).
​
countryId
string
Target country code for this keyword.
​
languageId
string
Target language ID (defaults to English).

​
Response

{
  "success": true,
  "keywordId": "kw_xyz789"
}