Citera home
Browse documentation

Visibility

Visibility

Query AI search visibility by period and model.

Summarize with AIChatGPTClaudePerplexity

GET /v1/brands/{brand_id}/visibility

Stored scan aggregates — the same numbers the dashboard shows. This is not the Results page (use /results).

Query

Values

period

7d, 30d (default), 90d, 365d

model

chatgpt, claude, gemini, perplexity, grok, deepseek (omit for all-model aggregates)

limit, cursor

keyset over the per-scan points

category_id, region

reserved: any value → 422 validation_failed in v1

Only finished scans (done, partial, completed) inside the period count. Without model, the response uses all-model cycle aggregates. With model, it uses that model's runs (plus legacy blended runs). Returns visibility with summary (latest scan, the previous one and deltas) and paginated points.