{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/youtube/json-schema/youtube-activity-list-response-schema.json",
  "title": "ActivityListResponse",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/youtube-youtube-activities-api-openapi.yml#/components/schemas/ActivityListResponse",
  "properties": {
    "visitorId": {
      "type": "string",
      "description": "The visitorId identifies the visitor.",
      "deprecated": true
    },
    "tokenPagination": {
      "$ref": "#/$defs/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": "#/$defs/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": "#/$defs/PageInfo",
      "description": "General pagination information."
    }
  },
  "type": "object",
  "$defs": {
    "Activity": {
      "type": "object",
      "properties": {
        "id": {
          "description": "The ID that YouTube uses to uniquely identify the activity.",
          "type": "string"
        },
        "snippet": {
          "$ref": "#/$defs/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": "#/$defs/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."
    },
    "ActivityContentDetails": {
      "properties": {
        "comment": {
          "$ref": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/ActivityContentDetailsRecommendation",
          "description": "The `recommendation` object contains information about a recommended resource. This property is only present if the `snippet.type` is `recommendation`."
        },
        "promotedItem": {
          "$ref": "#/$defs/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": "#/$defs/ActivityContentDetailsUpload",
          "description": "The `upload` object contains information about the uploaded video. This property is only present if the `snippet.type` is `upload`."
        },
        "channelItem": {
          "$ref": "#/$defs/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": "#/$defs/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": "#/$defs/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"
    },
    "ActivityContentDetailsBulletin": {
      "description": "Details about a channel bulletin post.",
      "properties": {
        "resourceId": {
          "$ref": "#/$defs/ResourceId",
          "description": "The `resourceId` object contains information that identifies the resource associated with a bulletin post. @mutable youtube.activities.insert"
        }
      },
      "type": "object"
    },
    "ActivityContentDetailsChannelItem": {
      "type": "object",
      "properties": {
        "resourceId": {
          "$ref": "#/$defs/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."
    },
    "ActivityContentDetailsComment": {
      "type": "object",
      "description": "Information about a resource that received a comment.",
      "properties": {
        "resourceId": {
          "$ref": "#/$defs/ResourceId",
          "description": "The `resourceId` object contains information that identifies the resource associated with the comment."
        }
      }
    },
    "ActivityContentDetailsPlaylistItem": {
      "description": "Information about a new playlist item.",
      "type": "object",
      "properties": {
        "resourceId": {
          "$ref": "#/$defs/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."
        }
      }
    },
    "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."
    },
    "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": "#/$defs/ResourceId",
          "description": "The `seedResourceId` object contains information about the resource that caused the recommendation."
        },
        "resourceId": {
          "$ref": "#/$defs/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": "#/$defs/ResourceId",
          "description": "The `resourceId` object encapsulates information that identifies the resource associated with a social network post."
        }
      },
      "description": "Details about a social network post."
    },
    "ActivityContentDetailsSubscription": {
      "properties": {
        "resourceId": {
          "$ref": "#/$defs/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"
    },
    "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."
    },
    "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": "#/$defs/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"
    },
    "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"
    },
    "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"
        }
      }
    },
    "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"
    },
    "ThumbnailDetails": {
      "properties": {
        "standard": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The standard quality image for this resource."
        },
        "default": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The default image for this resource."
        },
        "high": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The high quality image for this resource."
        },
        "maxres": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The maximum resolution quality image for this resource."
        },
        "shortsAspectRatio": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The Shorts aspect ratio (9:16) image for this resource."
        },
        "qhd": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The quad high definition (1440p / 2K) quality image for this resource."
        },
        "uhd": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The ultra-high resolution (4K) quality image for this resource."
        },
        "fhd": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The full high definition (1080p) quality image for this resource."
        },
        "medium": {
          "$ref": "#/$defs/Thumbnail",
          "description": "The medium quality image for this resource."
        }
      },
      "description": "Internal representation of thumbnails for a YouTube resource.",
      "type": "object"
    },
    "TokenPagination": {
      "properties": {},
      "description": "Stub token pagination template to suppress results.",
      "type": "object"
    }
  }
}