Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Youtube Reports API

Operations for querying YouTube Analytics report data

Youtube Reports API is one of 36 APIs that Youtube publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Reports. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, authentication docs, an API reference, code examples, and 2 JSON Schemas.

This API exposes 3 operations across 3 paths, and defines 5 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://youtubeanalytics.googleapis.com/v2.

3 operations 3 paths 5 schemas 3 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://www.googleapis.com/youtube/v3
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

Youtube Reports API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 4 scopes. By default, every request must be authenticated.

  • OAuth2 — OAuth 2.0 authentication for YouTube Analytics API

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 3 GET. Each is listed below with its method, path, parameters, and response codes.

Reports 3

Operations for querying YouTube Analytics report data

GET
/reports
Youtube Query Analytics Reports
youtubeAnalytics.reports.query 11 params → 200400401403
GET
/jobs/{jobId}/reports
Youtube List Reports
youtubeReporting.reports.list 7 params → 200
GET
/jobs/{jobId}/reports/{reportId}
Youtube Get Report
youtubeReporting.reports.get 3 params → 200

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are Report (7 properties), QueryResponse (3 properties), ColumnHeader (3 properties), ListReportsResponse (2 properties). Each schema is shown below with its type and property counts.

ColumnHeader
object
Describes a single column in an Analytics report response, including its name, type, and data type.
3 properties
ErrorResponse
object
A standard error response returned by the YouTube Analytics API.
1 property
Report
object
7 properties
QueryResponse
object
Response to a successful YouTube Analytics query request containing the requested report data including column headers and rows of data.
3 properties
ListReportsResponse
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

youtube-reports-api-openapi.yml Raw ↑

Other APIs Youtube publishes across the network.

Youtube Channel Sections API
Youtube Channel Banners API
Youtube Members API
Youtube Memberships Levels API
Youtube Thumbnails API
Youtube Watermarks API
Youtube Video Abuse Report Reasons API
YouTube IFrame Player API
YouTube Subscribe Button
Youtube Playlist Images API
YouTube Content ID API
YouTube oEmbed API