measurement

Visibility over time

The window metric at every cycle close in the range: one point per asOf day the period rollup wrote, for the brand and each competitor, on one engine. Read from the period rollup only. Each point's metrics are DisplayableMetrics, so a close below ten responses is a gap in the line, never a zero. modelChanges marks the closes where the provider's model set differed from the previous close; a comparison across one is confounded (metrics.md §6.3). from defaults to ninety days back and is clamped to the plan's history window.

get/brands/{brandId}/visibility/series

Request

  • Base URL: https://shruwd.io/api/v1
  • URL: https://shruwd.io/api/v1/brands/{brandId}/visibility/series
  • Auth: HTTP bearer

Query parameters

engine'google_aio' | 'google_ai_mode' | 'chatgpt'

google_aio — Google AI Overviews. google_ai_mode — Google AI Mode, tracked since 2026-10-15. chatgpt — ChatGPT.

Defaults to google_aio.

window7 | 30 | 90

The rolling window each point describes, in days.

fromstring date

First day, inclusive. Defaults to 29 days before to. Clamped to the plan's history window.

tostring date

Last day, inclusive. Defaults to today (UTC).

Response

Visibility series.

engine'google_aio' | 'google_ai_mode' | 'chatgpt' required

google_aio — Google AI Overviews. google_ai_mode — Google AI Mode, tracked since 2026-10-15. chatgpt — ChatGPT.

windowDays7 | 30 | 90 required
historyFromstring date nullable required

Set when from was moved forward to the plan's history window.

pointsstring[] required

Cycle-close days in the range, ascending. Every entity's series is index-aligned with this.

Changes

No recorded changes to this operation across all 1 revision of this API.