Skip to main content
POST
Add prompts to a topic cluster
Add AI prompts (questions people ask AI tools) to a topic cluster. Body: prompts, where each item is { promptId } to link an existing prompt or { prompt, intent?, region? } to create one (max 2000 characters), plus optional intents and track. A prompt already in another topic is skipped. The response is { success, linked, created, skipped, promptsSkipped, alreadyLinked, promptIds }. Set track: true to have SnowSEO monitor how often your brand appears in AI-generated answers for the prompts it newly links. It enables tracking only; prompts already being tracked are not disabled.
Prompts are only analyzed when track is true. Analysis runs in the background and uses AI credits per platform for prompts that have never run; prompts your balance can’t cover are left untracked and counted in promptsSkipped. It may take a few minutes before AI visibility data appears.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Path Parameters

topicId
string
required

Topic cluster ID

Body

application/json
teamId
string
prompts
object[]

Each item is either { promptId } to link an existing prompt or { prompt, intent, region? } to create a new one. region is the structured country-level object { type, city, state, country, iso2, iso3 }; omit for worldwide.

intents
object

Map of prompt text → intent override

track
boolean

Whether to enable tracking on newly linked prompts

Response

Default Response

success
boolean
required
linked
number
required
created
number
required
promptIds
string[]
required
skipped
number
promptsSkipped
number
alreadyLinked
number