list_personas

List all buyer personas for a brand. Personas represent different buyer types (e.g., "Technical Startup Founder", "Enterprise CMO"). Each persona gets different AI responses because they have different context and intent.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID to list personas for.

Response

{
  "syntheticId": 1234,
  "brandName": "Example",
  "personaCount": 3,
  "personas": [
    {
      "id": "persona-1",
      "name": "Technical Startup Founder",
      "role": "CTO / Technical Co-Founder",
      "demographics": "25-40, technical background, leading engineering at early-stage startup",
      "goals": ["Find efficient developer tools", "Reduce manual SEO work"],
      "painPoints": ["Limited marketing budget", "No dedicated marketing team"],
      "systemContext": "You are a technical startup founder evaluating AI visibility tools...",
      "isActive": true
    }
  ]
}

Key fields

Field	Description
`personaCount`	Number of personas
`personas[].name`	Human-readable persona name
`personas[].role`	Job title or role
`personas[].goals`	What this persona is trying to achieve
`personas[].painPoints`	Challenges and frustrations
`personas[].systemContext`	The system prompt used when querying AI platforms from this persona's perspective
`personas[].isActive`	Whether this persona is included in scans

Parameters

Response

Key fields

On this page