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 a Model breakdown and an optional legacy Credit Source breakdown, subject to the same availability rules as v1; query_volume carries Feature, Project and Comet. Read the available axes from categories rather than assuming paid/promo data is present. 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. The example includes legacy funding data. For credit_usage, Credit Source and its paid/promo entries are omitted when funding data is unavailable or totals-only reporting is enabled; member totals and model breakdowns remain available. Missing funding data does not mean zero usage.
Available category breakdown labels for member rows, in canonical render order. Each label is a key in every row's by_categories. For credit_usage, the legacy Credit Source axis is optional; use this list rather than assuming paid/promo data is available.
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.