Skip to main content
POST
/
{brand_id}
/
prompts
Create Prompt
curl --request POST \
  --url https://api.scrunchai.com/v1/{brand_id}/prompts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "How do I choose between Jira and Asana?",
  "stage": "Comparison",
  "persona_id": 45,
  "tags": [
    "comparison",
    "software"
  ],
  "platforms": [
    "chatgpt",
    "claude"
  ]
}
'
{
  "id": 123,
  "text": "What are the best project management tools?",
  "stage": "Advice",
  "persona_id": 123,
  "platforms": [
    "chatgpt"
  ],
  "tags": [
    "<string>"
  ],
  "topics": [
    "<string>"
  ],
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
brand_id
integer
required

The unique identifier for the brand

Body

application/json

Input model for creating a new prompt to track AI visibility.

​
text
string
required

The prompt text to track across AI platforms

Example:

"How do I choose between Jira and Asana?"

​
stage
enum<string>
required

The customer journey stage this prompt represents:

  • Advice - Seeking recommendations or guidance
  • Awareness - Exploring a topic or problem space
  • Evaluation - Assessing specific options
  • Comparison - Comparing multiple options
  • Other - Doesn't fit other categories
Available options:
Advice,
Awareness,
Evaluation,
Comparison,
Other
​
persona_id
integer | null

Optional persona ID to associate with this prompt for segmented analysis

​
tags
string[]

Custom tags for categorizing and filtering prompts

Example:
["comparison", "software"]
​
platforms
enum<string>[]

AI platforms to track this prompt on. If empty, defaults to all supported platforms.

Supported platforms:

  • chatgpt - OpenAI ChatGPT
  • claude - Anthropic Claude
  • google_ai_overviews - Google AI Overviews (Search)
  • perplexity - Perplexity AI
  • meta - Meta AI
  • google_ai_mode - Google AI Mode
  • google_gemini - Google Gemini
  • copilot - Microsoft Copilot
Available options:
chatgpt,
claude,
google_ai_overviews,
perplexity,
meta,
google_ai_mode,
google_gemini,
copilot

Response

The newly created prompt

Represents a prompt being tracked for AI visibility, including its configuration and metadata.

​
id
integer
required

Unique identifier for the prompt

​
text
string
required

The prompt text being tracked

Example:

"What are the best project management tools?"

​
stage
enum<string>
required

The customer journey stage this prompt represents

Available options:
Advice,
Awareness,
Evaluation,
Comparison,
Other
​
persona_id
integer | null
required

ID of the associated persona, if any

​
platforms
enum<string>[]
required

AI platforms this prompt is tracked on

Available options:
chatgpt,
claude,
google_ai_overviews,
perplexity,
meta,
google_ai_mode,
google_gemini,
copilot
​
tags
string[]
required

Custom tags assigned to this prompt

​
topics
string[]
required

Auto-detected or assigned topics for this prompt

​
created_at
string<date-time>
required

Timestamp when the prompt was created