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.”

YouTube creators rely on data -- data about how their channel is performing, data about their video’s ratings, their earnings. Lots of data. That’s why we launched the YouTube Reporting API back in October, which helps you bulk up your data requests while keeping them on a low-quota diet.

Reports made with the API started from the day you scheduled them, going forward. Now that it’s been in the wild, we’ve heard another request loud and clear: you don’t just want current data, you want older data, too. We’re happy to announce that the Reporting API now delivers historical data covering 180 days prior to when the reporting job is first scheduled (or July 1st, 2015, whichever is later.)

Developers with a keen eye may have already noticed this, as it launched a few weeks ago! Just in case you didn’t, you can find more information on how historical data works by checking out the Historical Data section of the Reporting API docs.

(Hint: if you’ve already got some jobs scheduled, you don’t need to do anything! We’ll generate the data automatically.)

New to the Reporting API? Tantalized by the possibility of all that historical data? Our documentation explains everything you need to know about scheduling jobs and the types of reports available. Try it out with our API Explorer, then dive into the sample code or write your own with one of our client libraries.

Happy reporting,

YouTube Developer Relations on behalf of Alvin Cham, Markus Lanthaler, Matteo Agosti, and Andy Diamondstein