Metrics Over Time
One point per collection date for the selected score, aggregated across every selected engine and thematic. score picks the series: presence_rate (domain, domain citation or brand mention presence, %), influence_score (share of an AI answer’s citations pointing to the project’s domain, averaged over answers with at least one citation, a 0-100 score) or average_position (average best domain or ranked-citation position, lower is better). Uses an explicit inclusive date_start/date_end range: no period snapping, no previous-period comparison and no latest-N collect cap. Dates without a finished collect are absent from the series and an empty range returns []; a date whose collects hold nothing in scope reports a zero point (with total/response_count 0 where the score has a count, which tells it apart from a genuine 0). metric_type depends on the score: presence_rate accepts domain, citation or brand (default domain); average_position accepts domain or citation (default domain); influence_score accepts none and rejects the parameter with a 422. brand only applies to presence_rate with metric_type=brand and is a 422 otherwise. Each item carries score, which tells the item shapes apart.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Score to return one point per collection date for.
presence_rate, influence_score, average_position Which records the score is computed over. presence_rate: domain, citation or brand (default domain). average_position: domain or citation (default domain). influence_score: not accepted.
domain, citation, brand Brand override for presence_rate with metric_type=brand; defaults to the project brand terms. Rejected with a 422 for any other combination.
Start of the date range (YYYY-MM-DD).
End of the date range (YYYY-MM-DD, inclusive).
Bing, BingAIO, ChatGPT, Perplexity, Google, GoogleAIO, GoogleAIMode, Claude, Gemini, AmazonRufus, Grok, Copilot, Mistral Filter by a list of thematic IDs
Filter by a list of keyword types
Generic, Brand Filter by a list of Funnel Stages
ToFu, MoFu, BoFu Filter by a list of persona IDs
Filter by a list of topic IDs
Filter by to get results related to neutral prompts, without weakness or strength
Filter by a list of strength IDs
Filter by a list of weakness IDs
Response
Successful Response
- PresenceRateTimeseriesItem
- InfluenceScoreTimeseriesItem
- AveragePositionTimeseriesItem
Discriminator: the score this item belongs to.
presence_rate Collection date in YYYY-MM-DD format.
Presence metric selected by the request.
domain, citation, brand Presence rate (%) on this date, across every selected engine and thematic. Always numeric: a date whose collects held nothing in scope reports 0 with total 0, which is what distinguishes it from a genuine 0% over a non-zero total.
Distinct eligible keyword/collect/engine observations on this date.
Distinct observations containing the matching domain or brand.