Method jobs.reports.get
Stay organized with collections
Save and categorize content based on your preferences.
Page Summary
This endpoint retrieves metadata for a specific report using its jobId and reportId.
Authorization is required for all requests, utilizing OAuth 2.0 and specific scopes like https://www.googleapis.com/auth/yt-analytics.readonly or https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
Path parameters jobId and reportId are required to identify the job and the report being retrieved.
The onBehalfOfContentOwner query parameter allows specifying a content owner ID, otherwise, the request defaults to the user's own channel.
A successful response returns a Report resource containing the report's metadata.
Retrieves the metadata for a specific report.
Request
HTTP request
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}
Authorization
All YouTube Reporting API requests must be authorized. The Authorization guide explains how to use the OAuth 2.0 protocol to retrieve authorization tokens.
YouTube Reporting API requests use the following authorization scopes:
View YouTube Analytics monetary reports for your YouTube content. This scope provides access to user activity metrics and to estimated revenue and ad performance metrics.
Parameters
Path parameters
Parameters
jobId
string
The ID that YouTube uses to uniquely identify the job associated with the report that is being retrieved.
reportId
string
The ID that YouTube uses to uniquely identify the report that is being retrieved.
Query parameters
Parameters
onBehalfOfContentOwner
string
The ID of the content owner for whom the API request is being made. If the request does not specify a value for this parameter, the API server assumes that the request is being made for the user's own channel.
Request body
The request body must be empty.
Response
If successful, the response body contains a Report resource.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-01-15 UTC."],[],["This describes how to retrieve metadata for a specific YouTube report using the Reporting API. A `GET` request is sent to a URL containing the `jobId` and `reportId`. Authorization is required using OAuth 2.0, with scopes for viewing analytics and/or monetary reports. The request can also specify a `content owner` using `onBehalfOfContentOwner`. The request body is empty. A successful response returns a `Report` resource.\n"]]
