Add Topics

Add new topics and search queries to expand what Pendium monitors during visibility scans.

POST /api/visibility/topics

Authentication: Required

Add a new topic with search queries, or add queries to an existing topic. Topics define what questions Pendium asks AI platforms — adding more topics means more coverage in your next scan.

Request body

Create a new topic with queries:

{
  "syntheticId": 1234,
  "name": "Pricing Comparison",
  "queries": [
    { "query": "cheapest project management tool" },
    { "query": "project management pricing comparison" },
    { "query": "free project management software" }
  ]
}

Add queries to an existing topic:

{
  "syntheticId": 1234,
  "topicId": "topic-uuid-1",
  "queries": [
    { "query": "enterprise project management tools" }
  ]
}

Field	Type	Required	Description
`syntheticId`	integer	Yes	The brand agent ID.
`name`	string	When creating a new topic	Name for the new topic.
`topicId`	string	When adding to existing	ID of the topic to add queries to.
`queries`	array	Yes	Array of `{ "query": "search query text" }` objects.

Example

curl -X POST https://pendium.ai/api/visibility/topics \
  -H "Content-Type: application/json" \
  -H "x-api-key: pk_live_xxxxxxxxxxxx" \
  -d '{
    "syntheticId": 1234,
    "name": "Pricing Comparison",
    "queries": [
      { "query": "cheapest project management tool" },
      { "query": "free project management software" }
    ]
  }'

Response

{
  "success": true,
  "topic": {
    "id": "topic-uuid-new",
    "name": "Pricing Comparison",
    "queryCount": 2
  },
  "queriesAdded": 2,
  "_pendium": {
    "what_happened": "Added topic 'Pricing Comparison' with 2 queries...",
    "next_steps": ["Trigger a scan to test these new queries..."]
  }
}

Tips for good queries

Write them like a real person would ask an AI. "What's the best CRM for small businesses?" beats "CRM small business."
Cover different intents. Mix informational ("how to choose a CRM"), comparison ("best CRM alternatives to Salesforce"), and transactional ("CRM pricing plans") queries.
Include competitor queries. "Is [Competitor] worth it?" and "[Competitor] alternatives" are high-value queries where you want to appear.

Request body

Example

Response

Tips for good queries

On this page