List Topics

See all the topics and search queries Pendium uses when scanning a brand's AI visibility.

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

Authentication: Required

Topics are the categories of questions Pendium asks AI platforms during a scan. Each topic has a set of search queries — things like "best project management tools for startups" or "how to choose a CRM."

Use this to see what's currently being tracked, and Add Topics to expand coverage.

Query parameters

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

Example

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

Response

{
  "syntheticId": 1234,
  "topicCount": 3,
  "topics": [
    {
      "id": "topic-uuid-1",
      "name": "Project Management",
      "queryCount": 8,
      "queries": [
        { "id": "q-1", "query": "best project management tools for startups" },
        { "id": "q-2", "query": "project management software comparison" }
      ]
    },
    {
      "id": "topic-uuid-2",
      "name": "Team Collaboration",
      "queryCount": 5,
      "queries": [
        { "id": "q-3", "query": "best team collaboration tools" }
      ]
    }
  ],
  "_pendium": {
    "what_you_are_seeing": "3 topics with 13 total queries..."
  }
}

What topics tell you

Topic name — The category (e.g. "Project Management", "Pricing Comparison")
Queries — The actual questions asked to AI platforms during scans. These are the conversations where you want your brand to show up.
Query count — How many queries per topic. More queries = more coverage but more credits per scan.

Query parameters

Example

Response

What topics tell you

On this page