Skip to main content
POST
/
topic-clusters
/
{topicId}
/
prompts
Topic Prompts
curl --request POST \
  --url https://v3-api-beta.snowseo.com/snowseo/v2/topic-clusters/{topicId}/prompts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "teamId": "<string>",
  "prompts": [
    "<string>"
  ],
  "intents": {},
  "volumes": {}
}
'
Add AI prompts (questions people ask AI tools) to a topic cluster. SnowSEO will monitor how often your brand appears in AI-generated answers for these prompts.

​
Request

​
topicId
string
required
The ID of the topic cluster.
​
teamId
string
required
Your team ID.
​
prompts
string[]
required
An array of prompt strings to track (e.g., ["What is the best SEO tool?", "How to do a website audit?"]).
​
intents
object
Optional. Map of prompt text to intent label (e.g., {"What is the best SEO tool?": "comparison"}).
​
volumes
object
Optional. Map of prompt text to estimated monthly search volume.

​
Response

{
  "success": true,
  "linked": 3,
  "created": 2
}
Newly added prompts are analyzed automatically in the background. It may take a few minutes before AI visibility data appears for new prompts.