With the launch of the YouTube Reporting API last year, we introduced a mechanism to download raw YouTube Analytics data. It generates a set of predefined reports in the form of CSV files that contain YouTube Analytics data for content owners. Once activated, reports are generated regularly, and each one contains data for a unique, 24-hour period. We heard that you also wanted more data to be accessible via the YouTube Reporting API service.

So today, we are making a set of system-managed ad revenue reports available to content owners. Previously, this data was only available via manually downloadable reports in Creator Studio. The system-managed reports released via the YouTube Reporting API maintain the same breakdowns as downloadable reports, but the schema is optimized to align to other reports available via this API.

These new reports are generated automatically for eligible YouTube Partners. Thus, if you are an eligible YouTube partner, you don't even need to create reporting jobs. Just follow the instructions below to find out whether the reports are available to you and to download the reports themselves.

We also want to let you know that more reports will be available via the YouTube Reporting API service in the coming weeks and months. Please keep an eye on the revision history to find out when additional reports become available.

How to start using the new reports

Check what new report types are available to you

1. Get an OAuth token (authentication credentials)
2. Call the reportTypes.list method with the includeSystemManaged parameter set to true.
3. The response lists all report types available to you. As you can’t use the new report types to create reporting jobs yourself, their systemManaged property is set to true.

Check if system-managed jobs have been created for you

1. Get an OAuth token (authentication credentials)
2. Call the jobs.list method with the includeSystemManaged parameter set to true. This will return a list of the available reporting jobs. All jobs with the systemManaged property set to true are jobs for the new report types.
3. Store the IDs of the jobs you want download reports for.

Download reports

1. Get an OAuth token (authentication credentials)
2. Call the reports.list method with the jobId parameter set to the ID found in the previous section to retrieve a list of downloadable reports created by that job.
3. Choose a report from the list and download it using its downloadUrl.

Client libraries and sample code
Client libraries exist for many different programming languages to help you use the YouTube Reporting API. Our Java, PHP, and Python code samples will help you get started. The API Explorer lets you try out sample calls before writing any code.

Posted by Markus Lanthaler, Tech Lead YouTube Analytics APIs, recently watched “Crushing gummy bears with hydraulic press” and Mihir Kulkarni, Software Engineer, recently watched “The $21,000 first class airplane seat.”