YouTube and YouTube Music Schema Reference

  • You can export your uploaded video media, including private, unlisted, and public videos, with associated data like interactions, recording information, and text.

  • Data about your YouTube channel, including feature settings, images, page settings, URL configurations, community moderation, pronouns, and brand connect data, is available for export.

  • Information regarding your YouTube channel subscriptions, playlists (private, unlisted, and public), comments you've created, live chats you've authored, posts, and clips is exportable.

  • Data related to YouTube Music, including uploaded music media, library songs, and metadata, can be exported.

  • Your YouTube Shopping wishlists and wishlist items, as well as YouTube Playable settings and saved game data, are available for export.

Exported Object: video media
Exported Object represents: Videos you've uploaded
Object is exported in these formats: Original format / MP4
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Exported Object: videos
Exported Object represents: The video entity data
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Video IDUnique video ID used to identify the video belonging to a playlist.

Examples:
pRXlrbuLZek
string
Approx Duration (ms)The approximate duration of the video in milliseconds.

Examples:
1234
int64
Video Audio LanguageVideo audio language.

Examples:
en
string
Video CategoryVideo category.

Examples:
Unspecified Category
Film
enum
Video Description (Original)Video original description provided by creator.

Examples:
This is fun video
string
Video Description (Original) LanguageThe language of a YouTube Video's original description provided by creator.

Examples:
en
string
Channel IDYouTube Video creator's channel ID.

Examples:
UCGg-UqjRgzhYDPJMr-9HXCg
string
TagYouTube Video tag (keyword).

Examples:
fun video
string
Video Title (Original)Video original title (name) provided by creator.

Examples:
New Funny and Fail Videos 2023
string
Video Title (Original) LanguageThe language of a YouTube Video's original title (name) provided by creator.

Examples:
en
string
Thumbnail URLYouTube Video translated Thumbnail URL.

Examples:
http://thumbnail_url
string
PrivacyThe privacy state of the video.

Examples:
Private
Public
enum
Video StateThe current state of the video upload.

Examples:
Uploaded
Processed
enum
Video Create TimestampThe timestamp indicating when a YouTube video was created.

Examples:
2023-07-17T17:52:49+00:00
timestamp
Video Publish TimestampThe timestamp indicating when a YouTube video was published.

Examples:
2023-07-17T18:52:49+00:00
timestamp
Exported Object: video interactions
Exported Object represents: Interactions on a YouTube Video.
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Video Interactions IDThe video ID of the video being interacted with.

Examples:
pRXlrbuLZek
string
Creation TimeTime when the video interaction was created

Examples:
2023-07-17T17:52:49+00:00
timestamp
Interaction TypeThe type of interactive sticker on the video.

Examples:
CHANNEL_MENTION
VIDEO_LINK
WEB_LINK
enum
Channel Mention Channel IDThe Channel ID associated with a channel mention sticker on a video.

Examples:
UCGg-UqjRgzhYDPJMr-9HXCg
repeated string
Video Link Video IDThe video ID associated with a video link sticker on a video.

Examples:
pRXlrbuLZek
repeated string
Exported Object: video recording
Exported Object represents: Recording information about a YouTube video.
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Video Recording AddressAn arbitrary address title string returned by the Places API.

Examples:
NASA Johnson Space Center
string
Video Recording Address 2An arbitrary address title string returned by the Places API.

Examples:
London
string
Video Recording CountryThe country where the video was recorded in ISO 3166-1 alpha-2 country code format.

Examples:
DE
string
Video Recording DateThe date the video was recorded.

Examples:
2023-07-17T17:52:49+00:00
timestamp
Video IDVideo ID

Examples:
dhLQS_XCG0g
string
Video Recording AltitudeThe altitude of the video recording location.

Examples:
305.0
double
Video Recording LatitudeThe latitude of the video recording location.

Examples:
47.3653139
double
Video Recording LongitudeThe longitude of the video recording location.

Examples:
8.5244746
double
Place IDThe ID of the place where the video was recorded, derived from the Google Places API.

Examples:
ChIJgUbEo8cfqokR5lP9_Wh_DaM
string
Recording ZipThe zip code of the place where the video was recorded.

Examples:
94114
string
Exported Object: video text
Exported Object represents: Creator-provided structured text associated with a YouTube video.
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Video IDThe unique identifier for the video.

Examples:
pRXlrbuLZek
string
Create TimeThe time the video text entity was created for the video.

Examples:
2023-07-17T17:52:49+00:00
timestamp
Description Text SegmentsThe description associated with the video, broken into text segments.

Examples:
This is
my
video text description.
repeated string
Title Text SegmentsThe title associated with the video, broken into text segments.

Examples:
My
Video Title
repeated string
Update TimeThe time the video text entity was last updated.

Examples:
2023-07-17T17:52:49+00:00
timestamp
Exported Object: playlists
Exported Object represents: Playlists you've created
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Playlist IDThe YouTube Playlist ID as seen in URLs.

Examples:
PLpjK416fmKwSfobBm4dbk5nHT0KPqDETS
string
Add new videos to topA user setting that specifies whether to add new videos to the top of the playlist.

Examples:
true
bool
Translated Playlist Description Create TimestampThe creation time of the playlist description's translation as provided by the creator.

Examples:
2023-02-10T00:00:00Z
timestamp
Playlist Description LocaleThe locale of the playlist description's translation as provided by the creator.

Examples:
en-US
string
Translated Playlist DescriptionThe playlist description's translation message as provided by the creator.

Examples:
Playlist Description
string
Translated Playlist Description Update TimeThe update time of each translated message as provided by the creator.

Examples:
2023-02-10T00:00:00Z
timestamp
Playlist Description (Original)The original text of the playlist description.

Examples:
Funny videos
string
Playlist Description (Original) LanguageThe original language of the playlist description.

Examples:
en-US
string
Playlist Image Create TimestampThe creation time of a playlist image.

Examples:
2023-02-10T00:00:00Z
timestamp
Playlist Image URLA playlist image's FIFE URL.

Examples:
https://lh4.googleusercontent.com/JDjSmaNIR-Px5svzdyVwpGd9B6S8vaCt0sWMxGjpkHOm-u6Q4lmJhVrRwq3oz8MGu3QrfyqjrrDo4CZUtgIa6d97ig=s400-h200
string
Playlist Image HeightThe playlist image's height (in pixels).

Examples:
200
int32
Playlist Image WidthThe playlist image's width (in pixels).

Examples:
200
int32
Translated Playlist Title Create TimestampThe creation time of the playlist name's translation as provided by the creator.

Examples:
2023-02-10T00:00:00Z
timestamp
Playlist Title LocaleThe locale of the playlist name's translation as provided by the creator.

Examples:
en-US
string
Translated Playlist TitleThe playlist name's translation message as provided by the creator.

Examples:
Playlist Title
string
Translated Playlist Title Update TimestampThe update time of the playlist name's translation as provided by the creator.

Examples:
2023-02-10T00:00:00Z
timestamp
Playlist Title (Original)The original text of the playlist's name (title).

Examples:
My videos
string
Playlist Title (Original) LanguageThe original language of the playlist's name (title).

Examples:
en-US
string
Playlist Create TimestampA playlist's creation time.

Examples:
2023-02-10T00:00:00Z
string
Playlist update timestampThe latest update time for a playlist.

Examples:
2023-02-10T00:00:00Z
string
Playlist Video OrderThe order of the playlist video.

Examples:
Manual
Date Added (Newest)
enum
Playlist VisibilityThe value of the user's playlist visibility setting.

Examples:
Public
Private
Unlisted
enum
Exported Object: playlist videos
Exported Object represents: videos in each playlist
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Video IDThe unique video ID that identifies the video belongs to a playlist.

Examples:
pRXlrbuLZek
string
Playlist Video Creation TimestampThe timestamp when the video was added to the playlist.

Examples:
2023-07-17T17:52:49+00:00
timestamp
Exported Object: channel
Exported Object represents: Information about your channel.
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Channel IDThe channel's unique ID.

Examples:
UCGg-UqjRgzhYDPJMr-9HXCg
string
Associated URLUser-provided URLs associated with their channel.

Examples:
twitter.com/TeamYouTube
repeated string
CountryThe country with which the channel is associated.

Examples:
US
string
DescriptionThe channel's description.

Examples:
Welcome to my channel!
string
Description LanguageThe language of the description.

Examples:
en
string
TagA list of keyword tags associated with the channel.

Examples:
cats
coffee
repeated string
TitleTitle of the channel.

Examples:
Creator Insider
string
Title LanguageThe language of the title.

Examples:
en
string
Channel VisibilityThe channel's visibility setting.

Examples:
Public
Private
enum
Exported Object: channel community moderation settings
Exported Object represents: Channel wide settings shared among Live chat messages and comments.
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Channel IDUnique channel ID.

Examples:
UCkRfArvrzheW2E7b6SVT7vQ
string
Blocked WordsBlocked words set by YouTube Channel owner.

Examples:
blockedwords1
blockedwords2
repeated string
Exported Object: channel feature data
Exported Object represents: YouTube Channel Feature Related Data.
Object is exported in these formats: CSV
Exported object has the following fields:
* The preceding fields represent key data fields for the purposes of parsing and ingesting the relevant data exports. Data fields produced in an export vary by service and user action and some services or actions don't produce each data field described.
Data Field *Field DefinitionData Field Type
Channel IDUnique channel ID.

Examples:
UCGg-UqjRgzhYDPJMr-9HXCg
string
Creator Redirects Settings: Channel ID Allowed to Redirect Live and Premiere VideosThe channels that are allowed to set the videos of this channel as redirect.

Examples:
UCGg-UqjRgzhYDPJMr-9HXCg
string
Gaming: Emoji PrefixChannel prefix prepended to each emoji shortcut of customized emoji.

Examples:
prefix
string
Gaming: Membership Badge Image URLMembership channel custom badge FIFE URL.

Examples:
http://lh3.googleusercontent.com/a/default-user
string
Live Chat Config: Channel Auto Moderation in Live ChatLive chat config whether auto moderation is enabled.

Examples:
true
bool
Studio App Settings: Keywords for Comment FilterComment Filter Keywords

Examples:
text search
string
Video Default: Allowed Comments TypeVideo default allowed comments type.

Examples:
Hold all comments for review
Not set
enum
Video Default: Targeted AudienceVideo default audience restriction.

Examples:
Not set
All audiences
enum
Video Default: LanguageVideo default audio language.

Examples:
en_US
string
Video Default: DescriptionVideo default description.

Examples:
defaults_description
string