Get Report

Fetch the full visibility report with raw LLM responses, scores, sources, and recommendations.

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

Authentication: Required

This is the big one. Returns the complete visibility report for a brand — every query result, every raw LLM response, cited sources, platform-by-platform scores, and the topics that were scanned.

Use this after a scan completes to understand exactly how AI platforms perceive the brand.

Query parameters

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

Example

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

Response

The response is large and detailed. Here's the structure:

{
  "syntheticId": 1234,
  "brandName": "Example",
  "scanDate": "2026-03-17T14:30:00Z",
  "overallScore": 62,
  "platformScores": {
    "chatgpt": 71,
    "claude": 58,
    "gemini": 55,
    "aio": 64
  },
  "queryResults": [
    {
      "query": "best project management tools for startups",
      "platform": "chatgpt",
      "model": "gpt-4o-mini",
      "mentioned": true,
      "sentiment": "positive",
      "position": 2,
      "rawResponse": "Here are the top project management tools for startups: 1. Notion...",
      "citedSources": [
        { "url": "https://example.com/features", "title": "Example Features" }
      ],
      "competitors": ["Notion", "Asana", "Monday.com"]
    }
  ],
  "topics": [
    {
      "id": "topic-uuid",
      "name": "Project Management",
      "queries": ["best project management tools", "project management for startups"]
    }
  ],
  "reportUrl": "https://pendium.ai/1234/visibility",
  "brandPageUrl": "https://pendium.ai/brands/example",
  "_pendium": {
    "what_you_are_seeing": "Full visibility report with 30 query results across 4 platforms...",
    "how_to_use": "Look at queryResults to see exactly what each AI said..."
  }
}

Key fields

Field	What it tells you
`overallScore`	0–100 composite score across all platforms
`platformScores`	Per-platform breakdown (chatgpt, claude, gemini, aio)
`queryResults`	Every individual query — what was asked, what the AI said, whether the brand was mentioned, sentiment, position in the response, and which competitors appeared
`queryResults[].rawResponse`	The actual text the AI returned — useful for understanding context and tone
`queryResults[].citedSources`	URLs the AI referenced — shows which content is driving visibility
`queryResults[].competitors`	Other brands mentioned in the same response
`topics`	The topic groups and queries that were scanned

What to do with this data

Find gaps: Look for queries where mentioned is false — these are conversations where the brand is invisible
Spot competitors: Check competitors arrays to see who's getting recommended instead
Identify strong content: Look at citedSources to see which pages are actually driving AI mentions
Compare platforms: Some brands are visible on ChatGPT but invisible on Claude — the platform scores show where to focus

Query parameters

Example

Response

Key fields

What to do with this data

On this page