YouTube Activities API

The Activities API from YouTube — 1 operation(s) for activities.

GitHub OpenAPI

Operations 1

GET /youtube/v3/activities List activities #

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-activities-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-activities-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: YouTube Data API v3 Activities API
  version: v3
  description: Generated from Google's published Discovery document for YouTube Data API v3 (youtube v3, revision 20261111). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://youtube.googleapis.com
tags:
- name: Activities
paths:
  /youtube/v3/activities:
    get:
      operationId: youtube.activities.list
      summary: List activities
      description: Retrieves a list of resources, possibly filtered.
      parameters:
      - name: channelId
        in: query
        required: false
        schema:
          type: string
      - name: home
        in: query
        required: false
        schema:
          type: boolean
          deprecated: true
      - name: maxResults
        in: query
        required: false
        description: The *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
        schema:
          maximum: 50
          type: integer
          minimum: 0
          default: '5'
          format: uint32
      - name: mine
        in: query
        required: false
        schema:
          type: boolean
      - name: pageToken
        in: query
        required: false
        description: The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
        schema:
          type: string
      - name: part
        in: query
        required: true
        description: The *part* parameter specifies a comma-separated list of one or more activity resource properties that the API response will include. If the parameter identifies a property that contains child properties, the child properties will be included in the response. For example, in an activity resource, the snippet property contains other properties that identify the type of activity, a display title for the activity, and so forth. If you set *part=snippet*, the API response will also contain all of those nested properties.
        schema:
          type: array
          items:
            type: string
      - name: publishedAfter
        in: query
        required: false
        schema:
          type: string
          format: google-datetime
      - name: publishedBefore
        in: query
        required: false
        schema:
          type: string
          format: google-datetime
      - name: regionCode
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivityListResponse'
        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/youtube
        - https://www.googleapis.com/auth/youtube.force-ssl
        - https://www.googleapis.com/auth/youtube.readonly
      - apiKey: []
      tags:
      - Activities
components:
  schemas:
    ActivityContentDetailsPlaylistItem:
      description: Information about a new playlist item.
      type: object
      properties:
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object contains information about the resource that was added to the playlist.
        playlistId:
          type: string
          description: The value that YouTube uses to uniquely identify the playlist.
        playlistItemId:
          type: string
          description: ID of the item within the playlist.
    ActivityListResponse:
      properties:
        visitorId:
          type: string
          description: The visitorId identifies the visitor.
          deprecated: true
        tokenPagination:
          $ref: '#/components/schemas/TokenPagination'
        prevPageToken:
          type: string
          description: The token that can be used as the value of the pageToken parameter to retrieve the previous page in the result set.
        kind:
          description: 'Identifies what kind of resource this is. Value: the fixed string "youtube#activityListResponse".'
          default: youtube#activityListResponse
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/Activity'
        nextPageToken:
          type: string
          description: The token that can be used as the value of the pageToken parameter to retrieve the next page in the result set.
        eventId:
          type: string
          description: Serialized EventId of the request which produced this response.
          deprecated: true
        etag:
          description: Etag of this resource.
          type: string
        pageInfo:
          $ref: '#/components/schemas/PageInfo'
          description: General pagination information.
      type: object
    ActivityContentDetailsUpload:
      type: object
      properties:
        videoId:
          type: string
          description: The ID that YouTube uses to uniquely identify the uploaded video.
      description: Information about the uploaded video.
    ActivityContentDetailsComment:
      type: object
      description: Information about a resource that received a comment.
      properties:
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object contains information that identifies the resource associated with the comment.
    ActivityContentDetailsPromotedItem:
      type: object
      properties:
        videoId:
          type: string
          description: The ID that YouTube uses to uniquely identify the promoted video.
        ctaType:
          description: The type of call-to-action, a message to the user indicating action that can be taken.
          enum:
          - ctaTypeUnspecified
          - visitAdvertiserSite
          type: string
        descriptionText:
          description: The text description to accompany the promoted item.
          type: string
        customCtaButtonText:
          type: string
          description: The custom call-to-action button text. If specified, it will override the default button text for the cta_type.
        creativeViewUrl:
          description: The URL the client should ping to indicate that the user was shown this promoted item.
          type: string
        forecastingUrl:
          items:
            type: string
          description: The list of forecasting URLs. The client should ping all of these URLs when a promoted item is not available, to indicate that a promoted item could have been shown.
          type: array
        impressionUrl:
          description: The list of impression URLs. The client should ping all of these URLs to indicate that the user was shown this promoted item.
          type: array
          items:
            type: string
        clickTrackingUrl:
          description: The URL the client should ping to indicate that the user clicked through on this promoted item.
          type: string
        adTag:
          type: string
          description: The URL the client should fetch to request a promoted item.
        destinationUrl:
          description: The URL the client should direct the user to, if the user chooses to visit the advertiser's website.
          type: string
      description: Details about a resource which is being promoted.
    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
    Thumbnail:
      description: A thumbnail is an image representing a YouTube resource.
      properties:
        width:
          type: integer
          description: (Optional) Width of the thumbnail image.
          format: uint32
        url:
          type: string
          description: The thumbnail image's URL.
        height:
          format: uint32
          description: (Optional) Height of the thumbnail image.
          type: integer
      type: object
    ActivityContentDetailsChannelItem:
      type: object
      properties:
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object contains information that identifies the resource that was added to the channel.
      description: Details about a resource which was added to a channel.
    ThumbnailDetails:
      properties:
        standard:
          $ref: '#/components/schemas/Thumbnail'
          description: The standard quality image for this resource.
        default:
          $ref: '#/components/schemas/Thumbnail'
          description: The default image for this resource.
        high:
          $ref: '#/components/schemas/Thumbnail'
          description: The high quality image for this resource.
        maxres:
          $ref: '#/components/schemas/Thumbnail'
          description: The maximum resolution quality image for this resource.
        shortsAspectRatio:
          $ref: '#/components/schemas/Thumbnail'
          description: The Shorts aspect ratio (9:16) image for this resource.
        qhd:
          $ref: '#/components/schemas/Thumbnail'
          description: The quad high definition (1440p / 2K) quality image for this resource.
        uhd:
          $ref: '#/components/schemas/Thumbnail'
          description: The ultra-high resolution (4K) quality image for this resource.
        fhd:
          $ref: '#/components/schemas/Thumbnail'
          description: The full high definition (1080p) quality image for this resource.
        medium:
          $ref: '#/components/schemas/Thumbnail'
          description: The medium quality image for this resource.
      description: Internal representation of thumbnails for a YouTube resource.
      type: object
    ActivityContentDetailsRecommendation:
      type: object
      description: Information that identifies the recommended resource.
      properties:
        reason:
          type: string
          enum:
          - reasonUnspecified
          - videoWatched
          description: The reason that the resource is recommended to the user.
        seedResourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `seedResourceId` object contains information about the resource that caused the recommendation.
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object contains information that identifies the recommended resource.
    ActivityContentDetailsSocial:
      type: object
      properties:
        type:
          enum:
          - unspecified
          - googlePlus
          - facebook
          - twitter
          description: The name of the social network.
          type: string
        author:
          description: The author of the social network post.
          type: string
        referenceUrl:
          type: string
          description: The URL of the social network post.
        imageUrl:
          description: An image of the post's author.
          type: string
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object encapsulates information that identifies the resource associated with a social network post.
      description: Details about a social network post.
    PageInfo:
      description: Paging details for lists of resources, including total number of items available and number of resources returned in a single page.
      properties:
        resultsPerPage:
          format: int32
          description: The number of results included in the API response.
          type: integer
        totalResults:
          description: The total number of results in the result set.
          type: integer
          format: int32
      type: object
    Activity:
      type: object
      properties:
        id:
          description: The ID that YouTube uses to uniquely identify the activity.
          type: string
        snippet:
          $ref: '#/components/schemas/ActivitySnippet'
          description: The `snippet` object contains basic details about the activity, including the activity's type and group ID.
        kind:
          description: 'Identifies what kind of resource this is. Value: The fixed string `"youtube#activity"`.'
          default: youtube#activity
          type: string
        etag:
          description: Etag of this resource
          type: string
        contentDetails:
          $ref: '#/components/schemas/ActivityContentDetails'
          description: The `contentDetails` object contains information about the content associated with the activity. For example, if the `snippet.type` value is `videoRated`, then the `contentDetails` object's content identifies the rated video.
      description: An `activity` resource contains information about an action that a particular channel, or user, has taken on YouTube. The actions reported in activity feeds include sharing a video, uploading a video, and so forth. Each `activity` resource identifies the type of action, the channel associated with the action, and the resource(s) associated with the action, such as the video that was rated or uploaded.
    ActivityContentDetailsBulletin:
      description: Details about a channel bulletin post.
      properties:
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object contains information that identifies the resource associated with a bulletin post. @mutable youtube.activities.insert
      type: object
    ActivitySnippet:
      type: object
      properties:
        groupId:
          type: string
          description: The group ID associated with the activity. A group ID identifies user events that are associated with the same user and resource. For example, if a user uploads a video and watches the same video, the entries for those events would have the same group ID in the user's activity feed. In your user interface, you can avoid repetition by grouping events with the same `groupId` value.
        type:
          enum:
          - typeUnspecified
          - upload
          - comment
          - subscription
          - playlistItem
          - recommendation
          - bulletin
          - social
          - channelItem
          - promotedItem
          type: string
          description: The type of activity that the resource describes.
        thumbnails:
          $ref: '#/components/schemas/ThumbnailDetails'
          description: A map of thumbnail images associated with the resource that is primarily associated with the activity. For each object in the map, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail.
        description:
          type: string
          description: The description of the resource primarily associated with the activity. @mutable youtube.activities.insert
        channelId:
          description: The ID that YouTube uses to uniquely identify the channel associated with the activity.
          type: string
        publishedAt:
          description: The date and time that the video was uploaded.
          type: string
          format: date-time
        title:
          type: string
          description: The title of the resource primarily associated with the activity.
        channelTitle:
          description: Channel title for the channel responsible for this activity
          type: string
      description: 'Basic details about an activity, including title, description, thumbnails, activity type and group. Next ID: 12'
    TokenPagination:
      properties: {}
      description: Stub token pagination template to suppress results.
      type: object
    ActivityContentDetails:
      properties:
        comment:
          $ref: '#/components/schemas/ActivityContentDetailsComment'
          description: The `comment` object contains information about a resource that received a comment. This property is only present if the `snippet.type` is `comment`.
        playlistItem:
          $ref: '#/components/schemas/ActivityContentDetailsPlaylistItem'
          description: The `playlistItem` object contains information about a new playlist item. This property is only present if the `snippet.type` is `playlistItem`.
        subscription:
          $ref: '#/components/schemas/ActivityContentDetailsSubscription'
          description: The `subscription` object contains information about a channel that a user subscribed to. This property is only present if the `snippet.type` is `subscription`.
        recommendation:
          $ref: '#/components/schemas/ActivityContentDetailsRecommendation'
          description: The `recommendation` object contains information about a recommended resource. This property is only present if the `snippet.type` is `recommendation`.
        promotedItem:
          $ref: '#/components/schemas/ActivityContentDetailsPromotedItem'
          description: The `promotedItem` object contains details about a resource which is being promoted. This property is only present if the `snippet.type` is `promotedItem`.
        upload:
          $ref: '#/components/schemas/ActivityContentDetailsUpload'
          description: The `upload` object contains information about the uploaded video. This property is only present if the `snippet.type` is `upload`.
        channelItem:
          $ref: '#/components/schemas/ActivityContentDetailsChannelItem'
          description: The `channelItem` object contains details about a resource which was added to a channel. This property is only present if the `snippet.type` is `channelItem`.
        social:
          $ref: '#/components/schemas/ActivityContentDetailsSocial'
          description: The `social` object contains details about a social network post. This property is only present if the `snippet.type` is `social`.
        bulletin:
          $ref: '#/components/schemas/ActivityContentDetailsBulletin'
          description: The `bulletin` object contains details about a channel bulletin post. This object is only present if the `snippet.type` is `bulletin`.
      description: 'Details about the content of an activity: the video that was shared, the channel that was subscribed to, etc.'
      type: object
    ActivityContentDetailsSubscription:
      properties:
        resourceId:
          $ref: '#/components/schemas/ResourceId'
          description: The `resourceId` object contains information that identifies the resource that the user subscribed to.
      description: Information about a channel that a user subscribed to.
      type: object
    ResourceId:
      type: object
      description: A resource id is a generic reference that points to another YouTube resource.
      properties:
        videoId:
          type: string
          description: The ID that YouTube uses to uniquely identify the referred resource, if that resource is a video. This property is only present if the resourceId.kind value is youtube#video.
        playlistId:
          type: string
          description: The ID that YouTube uses to uniquely identify the referred resource, if that resource is a playlist. This property is only present if the resourceId.kind value is youtube#playlist.
        channelId:
          type: string
          description: The ID that YouTube uses to uniquely identify the referred resource, if that resource is a channel. This property is only present if the resourceId.kind value is youtube#channel.
        kind:
          description: The type of the API resource.
          type: string
  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/youtube: Manage your YouTube account
            https://www.googleapis.com/auth/youtubepartner: View and manage your assets and associated content on YouTube
            https://www.googleapis.com/auth/youtube.channel-memberships.creator: See a list of your current active channel members, their current level, and when they became a member
            https://www.googleapis.com/auth/youtubepartner-channel-audit: View private information of your YouTube channel relevant during the audit process with a YouTube partner
            https://www.googleapis.com/auth/youtube.force-ssl: See, edit, and permanently delete your YouTube videos, ratings, comments and captions
            https://www.googleapis.com/auth/youtube.readonly: View your YouTube account
            https://www.googleapis.com/auth/youtube.upload: Manage your YouTube videos
externalDocs:
  url: https://developers.google.com/youtube/
x-provenance:
  method: harvested
  publisher: Google
  source: https://youtube.googleapis.com/$discovery/rest?version=v3
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261111)