YouTube Media API

The Media API from YouTube — 1 operation(s) for media.

GitHub OpenAPI

Operations 1

GET /v1/media/{mediaId} Download media #

Documentation

📖
Documentation
https://developers.google.com/youtube/v3/docs/activities/list
📖
GettingStarted
https://developers.google.com/youtube/v3/getting-started
📖
Authentication
https://developers.google.com/youtube/v3/guides/authentication
📖
Documentation
https://developers.google.com/youtube/v3/docs/channels/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/comments/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/commentThreads/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/playlists/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/playlistItems/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/search/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/subscriptions/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/videos/list
📖
Documentation
https://developers.google.com/youtube/v3/docs/captions
📖
Documentation
https://developers.google.com/youtube/v3/docs/videoCategories
📖
Documentation
https://developers.google.com/youtube/v3/docs/i18nLanguages
📖
Documentation
https://developers.google.com/youtube/v3/docs/i18nRegions
📖
Documentation
https://developers.google.com/youtube/analytics
📖
GettingStarted
https://developers.google.com/youtube/reporting/guides/authorization
📖
APIReference
https://developers.google.com/youtube/analytics/reference
📖
Authentication
https://developers.google.com/youtube/reporting/guides/authorization
📖
Documentation
https://developers.google.com/youtube/reporting
📖
APIReference
https://developers.google.com/youtube/reporting/v1/reference/rest
📖
Documentation
https://developers.google.com/youtube/reporting/v1/reports
📖
GettingStarted
https://developers.google.com/youtube/v3/live/getting-started
📖
Documentation
https://developers.google.com/youtube/v3/live/docs
📖
APIReference
https://developers.google.com/youtube/v3/live/docs

Specifications

Code Examples

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/youtube:youtube-media-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

youtube-media-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: YouTube Reporting Media API
  version: v1
  description: Generated from Google's published Discovery document for YouTube Reporting API (youtubereporting v1, revision 20261110). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://youtubereporting.googleapis.com
tags:
- name: Media
paths:
  /v1/media/{mediaId}:
    get:
      operationId: youtubereporting.media.download
      summary: Download media
      description: Method for media download. Download is supported on the URI `/v1/media/{+name}?alt=media`.
      parameters:
      - name: mediaId
        in: path
        required: true
        description: Resource name segment (mediaId).
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GdataMedia'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/yt-analytics-monetary.readonly
        - https://www.googleapis.com/auth/yt-analytics.readonly
      - apiKey: []
      tags:
      - Media
components:
  schemas:
    GdataDiffUploadRequest:
      description: gdata
      properties:
        checksumsInfo:
          $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
        objectInfo:
          $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
        objectVersion:
          description: gdata
          type: string
      type: object
    GdataMedia:
      description: gdata
      type: object
      properties:
        algorithm:
          description: gdata
          type: string
          deprecated: true
        diffVersionResponse:
          $ref: '#/components/schemas/GdataDiffVersionResponse'
          description: gdata
        referenceType:
          type: string
          enum:
          - PATH
          - BLOB_REF
          - INLINE
          - GET_MEDIA
          - COMPOSITE_MEDIA
          - BIGSTORE_REF
          - DIFF_VERSION_RESPONSE
          - DIFF_CHECKSUMS_RESPONSE
          - DIFF_DOWNLOAD_RESPONSE
          - DIFF_UPLOAD_REQUEST
          - DIFF_UPLOAD_RESPONSE
          - COSMO_BINARY_REFERENCE
          - ARBITRARY_BYTES
          description: gdata
        inline:
          type: string
          format: byte
          description: gdata
        isPotentialRetry:
          type: boolean
          description: gdata
        blobRef:
          type: string
          description: gdata
          format: byte
          deprecated: true
        sha1Hash:
          format: byte
          type: string
          description: gdata
        bigstoreObjectRef:
          description: gdata
          type: string
          format: byte
          deprecated: true
        downloadParameters:
          $ref: '#/components/schemas/GdataDownloadParameters'
          description: gdata
        filename:
          description: gdata
          type: string
        sha256Hash:
          type: string
          description: gdata
          format: byte
        diffDownloadResponse:
          $ref: '#/components/schemas/GdataDiffDownloadResponse'
          description: gdata
        length:
          format: int64
          type: string
          description: gdata
        crc32cHash:
          format: uint32
          type: integer
          description: gdata
        hash:
          type: string
          description: gdata
          deprecated: true
        mediaId:
          description: gdata
          format: byte
          type: string
        token:
          type: string
          description: gdata
        contentType:
          type: string
          description: gdata
        hashVerified:
          description: gdata
          type: boolean
        md5Hash:
          description: gdata
          type: string
          format: byte
        diffUploadRequest:
          $ref: '#/components/schemas/GdataDiffUploadRequest'
          description: gdata
        timestamp:
          description: gdata
          format: uint64
          type: string
        cosmoBinaryReference:
          type: string
          format: byte
          description: gdata
        compositeMedia:
          type: array
          items:
            $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
        path:
          type: string
          description: gdata
        diffChecksumsResponse:
          $ref: '#/components/schemas/GdataDiffChecksumsResponse'
          description: gdata
        sha512Hash:
          type: string
          format: byte
          description: gdata
        contentTypeInfo:
          $ref: '#/components/schemas/GdataContentTypeInfo'
          description: gdata
        diffUploadResponse:
          $ref: '#/components/schemas/GdataDiffUploadResponse'
          description: gdata
        objectId:
          $ref: '#/components/schemas/GdataObjectId'
          description: gdata
        blobstore2Info:
          $ref: '#/components/schemas/GdataBlobstore2Info'
          description: gdata
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    GdataContentTypeInfo:
      type: object
      description: gdata
      properties:
        fromFileName:
          description: gdata
          type: string
        fromBytes:
          description: gdata
          type: string
        fromUrlPath:
          description: gdata
          type: string
        fusionIdDetectionMetadata:
          description: gdata
          format: byte
          type: string
        fromHeader:
          description: gdata
          type: string
        bestGuess:
          description: gdata
          type: string
        fromFusionId:
          type: string
          description: gdata
    GdataObjectId:
      description: gdata
      properties:
        objectName:
          description: gdata
          type: string
        generation:
          format: int64
          type: string
          description: gdata
        bucketName:
          type: string
          description: gdata
      type: object
    GdataDiffUploadResponse:
      properties:
        originalObject:
          $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
        objectVersion:
          type: string
          description: gdata
      description: gdata
      type: object
    GdataCompositeMedia:
      description: gdata
      type: object
      properties:
        blobstore2Info:
          $ref: '#/components/schemas/GdataBlobstore2Info'
          description: gdata
        referenceType:
          type: string
          enum:
          - PATH
          - BLOB_REF
          - INLINE
          - BIGSTORE_REF
          - COSMO_BINARY_REFERENCE
          description: gdata
        path:
          description: gdata
          type: string
        sha1Hash:
          format: byte
          type: string
          description: gdata
        crc32cHash:
          type: integer
          description: gdata
          format: uint32
        cosmoBinaryReference:
          description: gdata
          type: string
          format: byte
        inline:
          type: string
          format: byte
          description: gdata
        objectId:
          $ref: '#/components/schemas/GdataObjectId'
          description: gdata
        blobRef:
          format: byte
          description: gdata
          type: string
          deprecated: true
        md5Hash:
          description: gdata
          format: byte
          type: string
        length:
          format: int64
          type: string
          description: gdata
    GdataDiffVersionResponse:
      properties:
        objectVersion:
          description: gdata
          type: string
        objectSizeBytes:
          format: int64
          description: gdata
          type: string
      type: object
      description: gdata
    GdataDiffDownloadResponse:
      properties:
        objectLocation:
          $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
      type: object
      description: gdata
    GdataDiffChecksumsResponse:
      type: object
      description: gdata
      properties:
        objectLocation:
          $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
        objectVersion:
          type: string
          description: gdata
        chunkSizeBytes:
          description: gdata
          format: int64
          type: string
        checksumsLocation:
          $ref: '#/components/schemas/GdataCompositeMedia'
          description: gdata
        objectSizeBytes:
          description: gdata
          type: string
          format: int64
    GdataBlobstore2Info:
      properties:
        blobId:
          type: string
          description: gdata
        readToken:
          description: gdata
          type: string
        uploadFragmentListCreationInfo:
          format: byte
          type: string
          description: gdata
        blobGeneration:
          format: int64
          description: gdata
          type: string
        uploadMetadataContainer:
          type: string
          description: gdata
          format: byte
        downloadExternalReadToken:
          type: string
          format: byte
          description: gdata
        downloadReadHandle:
          format: byte
          description: gdata
          type: string
      type: object
      description: gdata
    GdataDownloadParameters:
      description: gdata
      properties:
        ignoreRange:
          description: gdata
          type: boolean
        allowGzipCompression:
          description: gdata
          type: boolean
      type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/yt-analytics.readonly: View YouTube Analytics reports for your YouTube content
            https://www.googleapis.com/auth/yt-analytics-monetary.readonly: View monetary and non-monetary YouTube Analytics reports for your YouTube content
externalDocs:
  url: https://developers.google.com/youtube/reporting/v1/reports/
x-provenance:
  method: harvested
  publisher: Google
  source: https://youtubereporting.googleapis.com/$discovery/rest?version=v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261110)