List Personas

See the buyer personas Pendium uses to test how different customer types experience AI responses.

GET /api/visibility/personas?syntheticId={id}

Authentication: Required

Personas represent different types of buyers or users. During a visibility scan, Pendium tests each query from each persona's perspective — because AI platforms give different answers depending on who's asking.

A "Technical CTO" asking about project management tools gets a different response than a "Marketing Manager" asking the same question.

Query parameters

Parameter	Type	Required	Description
`syntheticId`	integer	Yes	The brand agent ID.

Example

curl "https://pendium.ai/api/visibility/personas?syntheticId=1234" \
  -H "x-api-key: pk_live_xxxxxxxxxxxx"

Response

{
  "syntheticId": 1234,
  "personaCount": 2,
  "personas": [
    {
      "id": "persona-uuid-1",
      "name": "Technical Startup Founder",
      "role": "CTO / Co-founder",
      "goals": ["Find tools that scale with the team", "Minimize context switching"],
      "painPoints": ["Too many tools", "Integration complexity"],
      "demographics": {
        "companySize": "10-50",
        "industry": "SaaS"
      }
    },
    {
      "id": "persona-uuid-2",
      "name": "Growth Marketer",
      "role": "Head of Growth",
      "goals": ["Drive organic traffic", "Improve conversion rates"],
      "painPoints": ["Attribution is hard", "Content takes too long to produce"]
    }
  ],
  "_pendium": {
    "what_you_are_seeing": "2 buyer personas used in visibility scans..."
  }
}

Why personas matter

Without personas, every scan query is asked from a generic perspective. With personas, Pendium injects each persona's background, goals, and context into the AI's system prompt — mimicking how real users with different backgrounds get different recommendations.

This means you can see: "ChatGPT recommends us to CTOs but not to marketers" — and create content that fills that gap.

Query parameters

Example

Response

Why personas matter

On this page