Statistics Resource

Description

The Statistics API helps you to obtain all kinds of useful statistics about your account, applications and AutoGraph tags. This includes both account usage statistics and statistics about the anti-fraud screening of your end-users/tags:

• Conversion statistics: the number of bytes of video that got converted/transcoded by the service.
• Storage statistics: the number of bytes that are stored/hosted by the service.
• Bandwidth statistics: the number of bytes that got transferred for downloading/streaming your videos.
• Antifraud statistics: the end-users/tags that are currently blocked by the anti-fraud system (users/tags held for fraud), together with the reason each one was blocked.

The usage statistics data can be queried individually at a "per-day" granularity (each statistics "record" returned corresponds to a one-day period, defined by from_date/to_date in the response JSON) or you can also query aggregated data between a given start and end date (action=aggregate). Always returned is a statistics "fact" (or an array of facts) consisting of the usage amount (in bytes), the corresponding time period and the user id (in the 'user' view) or the application id (in the 'application' view) the usage is accounted to.

Note: All usage that you don't link explicitly with one of your custom applications will be counted against a "default" application — this is e.g. currently the case for all conversion jobs you launch from the web UI.

Endpoints

• GET /stats/conversion: Get conversion statistics.
• GET /stats/storage: Get storage statistics.
• GET /stats/bandwidth: Get bandwidth statistics.
• GET /stats/bandwidth/tags/{tag}: Get bandwidth statistics for a specific AutoGraph Tag.
• GET /stats/bandwidth/tags: Get bandwidth statistics for the top 10 users with the highest bandwidth usage.
• GET /stats/antifraud/blocked_tags/: List the end-users/tags currently blocked by the anti-fraud system.
• GET /stats/antifraud/blocked_tags/{tag}: Get the blocked records of a specific AutoGraph Tag.
• DELETE /stats/antifraud/blocked_tags/{tag}: Unblock a specific AutoGraph Tag.

Authentication

All endpoints require a Bearer token for authentication.

Supported Methods

• GET: Retrieve various usage statistics.

Request Headers

• Authorization: Bearer [AUTH_TOKEN]

Common Parameters

• format: string (Optional)
  Values: json, xml
  Overrides the Request Accept header.
• human: boolean (Optional)
  Values: true, false
  If 'true', the response will be in a structured, more human-readable form.
• view: string (Optional)
  Values: user, application
  Default: user
  Whether to query the statistics for your overall user account (user) or separately per application (application).
• current_subscription: boolean (Optional)
  Values: true, false
  Default: false
  If true, the time period of your currently active subscription (= your current billing period) is queried. If false, all statistics of the current user are returned without any time/date restrictions.
• from_date: string (Optional)
  Format: YYYY-MM-DD'T'hh:mm:ss'Z' (e.g. 2025-04-19T00:00:00.000Z)
• to_date: string (Optional)
  Format: YYYY-MM-DD'T'hh:mm:ss'Z' (e.g. 2025-04-19T00:00:00.000Z)
• action: string (Optional)
  Values: aggregate
  Returns a summed-up aggregate over all (matching) statistics records instead of individual records. Currently, only aggregate is a valid action (others like average may follow in the future).

For detailed information about each method, please refer to the respective documentation files: GET.md, bandwidth.md, bandwidth-tags.md, conversion.md, storage.md and antifraud/blocked_tags/.