Visibility API | Genlytic Docs

GET/v1/visibility

Returns visibility snapshots for your workspace, most recent first.

Parameter	Req	Description
brandIdstring	—	Filter to a specific brand. Must be a valid MongoDB ObjectId string.
periodstring	—	`7d` `30d` `90d`. Filters snapshots by `created_at`. Omit to return all snapshots.
limitnumber	—	Page size, 1–100. Default: 50.
cursorstring	—	Pagination cursor from a previous response's `pagination.nextCursor`.

{
  "data": [
    {
      "id": "6868b4c1f2a3b4c5d6e7f8a9",
      "brandId": "6868b4c1f2a3b4c5d6e7f8a1",
      "score": 71,
      "delta": 3,
      "engines": ["gpt", "perplexity", "claude", "gemini"],
      "createdAt": "2026-06-12T09:41:00.000Z"
    }
  ],
  "pagination": { "hasMore": false, "nextCursor": null }
}

Fields are returned exactly as stored — score and delta are workspace-level visibility metrics, not per-engine breakdowns. There is no separate /scores or /snapshots sub-path; this single endpoint covers both current and historical values via the period filter.

POST/v1/scans

Trigger a manual scan across all configured engines.

Requires scans:write scope. Counts against your daily scan limit.

Parameter	Req	Description
brandIdstring	yes	Brand ID (`brd_...`)
promptIdsstring[]	—	Specific prompt IDs (`prm_...`) to scan. Omit to scan all active prompts.
enginesstring[]	—	Engines to scan: `gpt` `perplexity` `claude` `gemini`. Omit to use all configured engines.

{
  "data": {
    "scanBatchId": "scn_01hw...",
    "status": "running",
    "promptCount": 34,
    "engines": ["gpt", "perplexity"],
    "estimatedCompletionAt": "2026-06-12T09:51:00.000Z"
  }
}

Poll for completion or use the scan.completed webhook.