Skip to main content
The Configuration API lets you manage Scrunch brands at scale.
It is most commonly used by:
  • Agencies onboarding dozens or hundreds of clients
  • Enterprise teams automating persona and keyword setup
  • Internal tools (brand creation, batch updates, auditing)

What you can configure

Brands

  • Name, alternative names
  • Website + alternative websites
  • Competitors
  • Personas
  • Key topics

Prompts

  • Text
  • Stage
  • Tags
  • Personas
  • Platforms

Example: Create a brand

curl -X POST "https://api.scrunchai.com/v1/brands" \
  -H "Authorization: Bearer $SCRUNCH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spirit Airlines",
    "website": "https://spirit.com",
    "description": "Low cost air carrier."
  }'

Example: Add a prompt

curl -X POST "https://api.scrunchai.com/v1/1234/prompts" \
  -H "Authorization: Bearer $SCRUNCH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "What are the best budget airlines?",
    "tags": ["budget"],
    "platforms": ["chatgpt", "perplexity"]
  }'

Notes

To update prompt text, delete the old prompt and create a new one. Only tags and platforms can be updated in-place.

See all configuration endpoints

Explore the API reference →