Skip to main content
POST
Create or bulk-create tracked prompts
Add one or more prompts to AI Visibility tracking so SnowSEO monitors how your brand shows up in AI answers for them. Send a single prompt, or several at once via items. Prompts that run out of credits are created paused and counted in skipped. skipped appears only in bulk (items) responses.
Tracking and refreshing prompts may consume credits and depends on your plan. You can also manage tracked prompts from the AI Visibility dashboard.

More endpoints

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Body

application/json
prompt
string
required

Single prompt text

Maximum string length: 600
teamId
string
isEnabled
boolean

Whether to start tracking straight away. Defaults to true. Applies to prompt and is the default for every entry in items (an entry's own isEnabled wins). Pass false to add prompts without tracking them: nothing runs and no credits are spent until they are enabled, and prompts that already exist but are paused stay paused.

isBranded
boolean

Marks the prompt as brand-specific. Applies to prompt and is the default for every entry in items. Detected from the prompt text when omitted.

region
object | null

Optional region targeting. Applies to prompt and is the default for every entry in items. Omit for the team's default region, or pass null to track worldwide.

items
object[]

Bulk prompt items

enqueue
boolean

When false, skips only the immediate run. The prompt is still tracked, so the refresh cron picks it up and bills for it on its next tick. To add a prompt without tracking it, use isEnabled: false instead.

Response

Default Response

id
string

Single-prompt result

prompt
string
status
string
isEnabled
boolean
createdAt
string<date-time>
success
boolean

Bulk-create result

created
number
revived
number
enqueued
number
skipped
number
results
object[]