YouTube Jobs API

The Jobs API from YouTube — 4 operation(s) for jobs.

GitHub OpenAPI

Operations 6

GET /v1/jobs/{jobId} Get jobs #
DELETE /v1/jobs/{jobId} Delete jobs #
POST /v1/jobs Create jobs #
GET /v1/jobs List jobs #
GET /v1/jobs/{jobId}/reports/{reportId} Get reports #
GET /v1/jobs/{jobId}/reports List reports #

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-jobs-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-jobs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: YouTube Reporting Jobs API
  version: v1
  description: Generated from Google's published Discovery document for YouTube Reporting API (youtubereporting v1, revision 20261110). 6 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://youtubereporting.googleapis.com
tags:
- name: Jobs
paths:
  /v1/jobs/{jobId}:
    get:
      operationId: youtubereporting.jobs.get
      summary: Get jobs
      description: Gets a job.
      parameters:
      - name: jobId
        in: path
        required: true
        description: The ID of the job to retrieve.
        schema:
          type: string
      - name: onBehalfOfContentOwner
        in: query
        required: false
        description: The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        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:
      - Jobs
    delete:
      operationId: youtubereporting.jobs.delete
      summary: Delete jobs
      description: Deletes a job.
      parameters:
      - name: jobId
        in: path
        required: true
        description: The ID of the job to delete.
        schema:
          type: string
      - name: onBehalfOfContentOwner
        in: query
        required: false
        description: The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Empty'
        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:
      - Jobs
  /v1/jobs:
    post:
      operationId: youtubereporting.jobs.create
      summary: Create jobs
      description: Creates a job and returns it.
      parameters:
      - name: onBehalfOfContentOwner
        in: query
        required: false
        description: The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Job'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Job'
        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:
      - Jobs
    get:
      operationId: youtubereporting.jobs.list
      summary: List jobs
      description: Lists jobs.
      parameters:
      - name: includeSystemManaged
        in: query
        required: false
        description: If set to true, also system-managed jobs will be returned; otherwise only user-created jobs will be returned. System-managed jobs can neither be modified nor deleted.
        schema:
          type: boolean
      - name: onBehalfOfContentOwner
        in: query
        required: false
        description: The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).
        schema:
          type: string
      - name: pageSize
        in: query
        required: false
        description: Requested page size. Server may return fewer jobs than requested. If unspecified, server will pick an appropriate default.
        schema:
          format: int32
          type: integer
      - name: pageToken
        in: query
        required: false
        description: A token identifying a page of results the server should return. Typically, this is the value of ListReportTypesResponse.next_page_token returned in response to the previous call to the `ListJobs` method.
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListJobsResponse'
        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:
      - Jobs
  /v1/jobs/{jobId}/reports/{reportId}:
    get:
      operationId: youtubereporting.jobs.reports.get
      summary: Get reports
      description: Gets the metadata of a specific report.
      parameters:
      - name: jobId
        in: path
        required: true
        description: The ID of the job.
        schema:
          type: string
      - name: reportId
        in: path
        required: true
        description: The ID of the report to retrieve.
        schema:
          type: string
      - name: onBehalfOfContentOwner
        in: query
        required: false
        description: The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Report'
        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:
      - Jobs
  /v1/jobs/{jobId}/reports:
    get:
      operationId: youtubereporting.jobs.reports.list
      summary: List reports
      description: Lists reports created by a specific job. Returns NOT_FOUND if the job does not exist.
      parameters:
      - name: jobId
        in: path
        required: true
        description: The ID of the job.
        schema:
          type: string
      - name: createdAfter
        in: query
        required: false
        description: If set, only reports created after the specified date/time are returned.
        schema:
          type: string
          format: google-datetime
      - name: onBehalfOfContentOwner
        in: query
        required: false
        description: The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).
        schema:
          type: string
      - name: pageSize
        in: query
        required: false
        description: Requested page size. Server may return fewer report types than requested. If unspecified, server will pick an appropriate default.
        schema:
          type: integer
          format: int32
      - name: pageToken
        in: query
        required: false
        description: A token identifying a page of results the server should return. Typically, this is the value of ListReportsResponse.next_page_token returned in response to the previous call to the `ListReports` method.
        schema:
          type: string
      - name: startTimeAtOrAfter
        in: query
        required: false
        description: If set, only reports whose start time is greater than or equal the specified date/time are returned.
        schema:
          format: google-datetime
          type: string
      - name: startTimeBefore
        in: query
        required: false
        description: If set, only reports whose start time is smaller than the specified date/time are returned.
        schema:
          type: string
          format: google-datetime
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListReportsResponse'
        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:
      - Jobs
components:
  schemas:
    Empty:
      type: object
      description: 'A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }'
      properties: {}
    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
    Report:
      properties:
        id:
          description: The server-generated ID of the report.
          type: string
        downloadUrl:
          type: string
          description: The URL from which the report can be downloaded (max. 1000 characters).
        startTime:
          description: The start of the time period that the report instance covers. The value is inclusive.
          format: google-datetime
          type: string
        endTime:
          type: string
          description: The end of the time period that the report instance covers. The value is exclusive.
          format: google-datetime
        createTime:
          format: google-datetime
          description: The date/time when this report was created.
          type: string
        jobId:
          type: string
          description: The ID of the job that created this report.
        jobExpireTime:
          description: The date/time when the job this report belongs to will expire/expired.
          type: string
          format: google-datetime
      type: object
      description: A report's metadata including the URL from which the report itself can be downloaded.
    Job:
      type: object
      properties:
        reportTypeId:
          type: string
          description: The type of reports this job creates. Corresponds to the ID of a ReportType.
        expireTime:
          format: google-datetime
          type: string
          description: The date/time when this job will expire/expired. After a job expired, no new reports are generated.
        systemManaged:
          description: True if this a system-managed job that cannot be modified by the user; otherwise false.
          type: boolean
        name:
          type: string
          description: The name of the job (max. 100 characters).
        id:
          description: The server-generated ID of the job (max. 40 characters).
          type: string
        createTime:
          format: google-datetime
          type: string
          description: The creation date/time of the job.
      description: A job creating reports of a specific type.
    ListJobsResponse:
      type: object
      properties:
        nextPageToken:
          type: string
          description: A token to retrieve next page of results. Pass this value in the ListJobsRequest.page_token field in the subsequent call to `ListJobs` method to retrieve the next page of results.
        jobs:
          type: array
          description: The list of jobs.
          items:
            $ref: '#/components/schemas/Job'
      description: Response message for ReportingService.ListJobs.
    ListReportsResponse:
      properties:
        reports:
          description: The list of report types.
          items:
            $ref: '#/components/schemas/Report'
          type: array
        nextPageToken:
          type: string
          description: A token to retrieve next page of results. Pass this value in the ListReportsRequest.page_token field in the subsequent call to `ListReports` method to retrieve the next page of results.
      description: Response message for ReportingService.ListReports.
      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)