CDN Usage Report

A CDN usage report provides detailed information about the following:

  • Content Information: This includes the content's title, content ID, streaming type, and when the content was created.
  • CDN Consumed Date: The date when the CDN was consumed.
  • CDN Usage (GB): This is the amount of consumed CDN usage on a specific day.

Here is an example of a CDN report in CSV format for the CDN consumption that occurred during June 2023:

Generate the CDN Report

To generate a CDN report, you can use the following API:

GET /bv/analytics/v1/reports/cdn-usage

This API accepts two query parameters:

  • streaming_type: This specifies the content type you want to generate the report:
    • CDN_REPORT_STREAMING_TYPE_LIVE for live events
  • time: This specifies the month for the report in the ISO 8601 format (YYYY-MM-01T00:00:00Z). The report will include the total CDN consumption that occurred from the first day 00:00:00 to the last day 23:59:59 of the specified month.

Here's an example of a request in cURL:

curl --request GET \
  --url '' \
  --header 'Accept: application/json' \
  --header 'authorization: Bearer <your-api-token>' \
  --header 'x-bv-org-id: <your-organization-id>'

A successful response will contain a URL for the watch time report:

  "url": "string"

Now you can access your report by navigating to this URL.


  1. If the report is unavailable (1-2 days after the target month) or the specified month has no consumption occurred, the API will respond with a 404 error.
  2. The URL will expire after one hour. If it expires, please use this API again to fetch a new one.