get_scan_status

Poll the status of a visibility scan. Returns scan results if complete, or progress if still running. Call every 30–60 seconds after triggering a scan with scan_visibility.

Authentication: Required

Parameters

Parameter	Type	Required	Description
`syntheticId`	`integer`	Yes	The agent ID to check scan status for.

Response: scan complete

When the scan has finished, the response includes the full score summary:

{
  "scanAvailable": true,
  "syntheticId": 1234,
  "agentName": "Example",
  "scanId": 5678,
  "scanDate": "2026-03-20T12:00:00Z",
  "overallScore": 72,
  "visibilityLevel": "Moderate",
  "summary": "Example is mentioned in 65% of relevant AI queries...",
  "platformScores": [
    { "platform": "chatgpt", "score": 78 },
    { "platform": "claude", "score": 65 },
    { "platform": "gemini", "score": 71 },
    { "platform": "ai_overviews", "score": 74 }
  ],
  "personaScores": [...],
  "topCompetitors": [...],
  "recommendations": [...],
  "insights": { "strengths": [...], "gaps": [...], "opportunities": [...] },
  "scanStats": { "queryCount": 30, "llmCallCount": 120 },
  "reportUrl": "https://pendium.ai/r/abc123",
  "brandIndexUrl": "https://pendium.ai/brands/example"
}

Response: scan in progress

{
  "scanAvailable": false,
  "syntheticId": 1234,
  "agentName": "Example",
  "scanInProgress": true,
  "progress": {
    "completedQueries": 18,
    "totalQueries": 30
  },
  "message": "Scan running: 18/30 queries complete. Keep polling."
}

Response: no scan data

{
  "scanAvailable": false,
  "syntheticId": 1234,
  "scanInProgress": false,
  "message": "No scan results yet. The scan may still be initializing — keep polling."
}

Key fields

Field	Description
`overallScore`	0–100 visibility score across all platforms
`visibilityLevel`	Human-readable level: "Not Visible", "Low", "Moderate", "Good", "Strong"
`platformScores`	Per-platform breakdown (ChatGPT, Claude, Gemini, AI Overviews)
`personaScores`	Scores broken down by buyer persona
`topCompetitors`	Brands that appear in the same AI responses
`recommendations`	Actionable suggestions from the scan analysis
`reportUrl`	Shareable link to the visual report
`brandIndexUrl`	Link to the brand's public Brand Index page

Parameters

Response: scan complete

Response: scan in progress

Response: no scan data

Key fields

On this page