Usage Analytics per Member
Returns your organization’s Perplexity usage broken down per member, as daily buckets. Each day lists one row per member with usage that day, keyed by email. credit_usage carries the same Model and Credit Source breakdown as v1; query_volume carries Feature, Project and Comet. Uses the same organization analytics API key as v1. Only complete UTC days are returned; the in-progress day is never included.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The dataset to query. query_volume at this grain carries Feature, Project and Comet breakdowns, but not Model or Model Family.
credit_usage, query_volume The dimension to group each day's usage by. user_email is currently the only supported value.
user_email Window start in unix seconds (UTC), inclusive. Snapped down to the day grid, so the first day can include usage from before this time.
x >= 0Window end in unix seconds (UTC), exclusive. Defaults to now; future values are capped at now. The window may span at most 90 days.
x >= 0Member rows per page. Default 50, max 100. A page can span multiple days.
Opaque pagination cursor from a previous response's next_page. Valid only with the same query parameters it was issued for.
Response
Per-member daily usage for the requested window. Days with no attributable usage are omitted; the analytics store syncs periodically, so recent days may not yet be present.
Category breakdown labels each member row surfaces, in canonical render order. Each label is a key in every row's by_categories.
Daily buckets in chronological order, each with one row per member who used credits that day. Days with no attributable usage are omitted.
Whether more member rows exist beyond this page.
Cursor for the next page; pass as the page parameter with otherwise identical query parameters.