get_scan_history

Get historical visibility scan scores to track trends and measure content impact.

Get historical visibility scan scores to track trends over time. Shows how the brand's AI visibility has changed across scans. Use this to measure the impact of content you've created.

Authentication: Required

Parameters

Parameter	Type	Required	Default	Description
`syntheticId`	`integer`	Yes	—	The agent ID to get scan history for.
`limit`	`integer` (1–50)	No	`10`	Number of historical scans to return.

Response

{
  "syntheticId": 1234,
  "brandName": "Example",
  "scanCount": 5,
  "latestScore": 78,
  "scoreChange": 6,
  "scoreTrend": "improving",
  "history": [
    {
      "scanId": 5678,
      "scanDate": "2026-03-20T12:00:00Z",
      "overallScore": 78,
      "visibilityLevel": "Good",
      "summary": "...",
      "platformScores": [...],
      "personaScores": [...],
      "topCompetitors": [...],
      "citedSources": [...],
      "queryAnalysis": [...]
    },
    {
      "scanId": 5672,
      "scanDate": "2026-03-13T12:00:00Z",
      "overallScore": 72,
      "visibilityLevel": "Moderate",
      "summary": "..."
    }
  ]
}

Key fields

Field	Description
`latestScore`	Most recent overall visibility score (0–100)
`scoreChange`	Difference between the two most recent scans (positive = improving)
`scoreTrend`	`"improving"`, `"declining"`, or `"stable"`
`history`	Array of scan summaries ordered newest-first

Each history entry includes platformScores, personaScores, topCompetitors, citedSources, and queryAnalysis for detailed trend analysis.

Parameters

Response

Key fields

On this page