List of fields to return for requests in the playlist object. Retrieve them using the fields query-string parameter on any playlist object request.
| Fields | Description |
|---|---|
created_time | Date and time when this playlist was created. |
description | Comprehensive description of this playlist. |
id | Unique object identifier (unique among all playlists). |
item_type | Graph type of this object (hopefully playlist). |
name | Short descriptive name of this playlist. |
owner | Author of this playlist. |
private | True if this playlist is private. |
thumbnail_60_url | URL of this playlist’s first video thumbnail image (60px height). |
thumbnail_120_url | URL of this playlist’s first video thumbnail image (120px height). |
thumbnail_180_url | URL of this playlist’s first video thumbnail image (180px height). |
thumbnail_240_url | URL of this playlist’s first video thumbnail image (240px height). |
thumbnail_360_url | URL of this playlist’s first video thumbnail image (360px height). |
thumbnail_480_url | URL of this playlist’s first video thumbnail image (480px height). |
thumbnail_720_url | URL of this playlist’s first video thumbnail image (720px height). |
thumbnail_1080_url | URL of this playlist’s first video thumbnail image (1080px height). |
thumbnail_url | URL of the thumbnail of this playlist’s first video (raw, respecting full size ratio). |
updated_time | Date and time when this playlist was last updated. |
videos_total | Total amount of videos in this playlist. |
Default valuesThese fields are returned by default in the API answer when you do not specify specific fields in your API calls:
- id
- name
created_time
created_timeDate and time when this playlist was created.
| Type | Sample value | Read access | Write access |
|---|---|---|---|
| date | 1287507036 | Public | N/A |
description
descriptionComprehensive description of this playlist.
minimum lenght: 1 character / max lenght: 2000 characters
Type | Sample value | Read access | Write access |
|---|---|---|---|
| string |
| Public | Private, can be written by the owner of the object |
id
id
Unique object identifier (unique among all playlists)
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | xx64prk | Public | manage_videos scope |
item_type
item_typeGraph type of this object (hopefully playlist).
minimum lenght: 1 character / max lenght: 150 characters
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| date | playlist | Public | manage_videos scope |
name
nameShort descriptive name of this playlist.
minimum lenght: 1 character / max lenght: 50 characters
Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string |
| Public | Private, can be written by the owner of the object |
owner
ownerAuthor of this playlist. You can retrieve sub-fields of this user object using the dot-notation (e.g.: owner.id).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| string | x9nio8o | Public | N/A |
private
privateTrue if this playlist is private.
Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| boolean |
| Public | Private, can be written by the owner of the object |
thumbnail_60_url
thumbnail_60_urlURL of this playlist’s first video thumbnail image (60px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x60-epG.jpg | Public | N/A |
thumbnail_120_url
thumbnail_120_urlURL of this playlist’s first video’s thumbnail image (120px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x120-lbT.jpg | Public | N/A |
thumbnail_180_url
thumbnail_180_urlURL of this playlist’s first video’s thumbnail image (180px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x180-Pe8.jpg | Public | N/A |
thumbnail_240_url
thumbnail_240_urlURL of this playlist’s first video’s thumbnail image (240px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x240-bP7.jpg | Public | N/A |
thumbnail_360_url
thumbnail_360_urlURL of this playlist’s first video’s thumbnail image (360px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x360-AdG.jpg | Public | N/A |
thumbnail_480_url
thumbnail_480_urlURL of this playlist’s first video’s thumbnail image (480px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x480-kEp.jpg | Public | N/A |
thumbnail_720_url
thumbnail_720_urlURL of this playlist’s first video’s thumbnail image (720px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/3CQ3/x720-LZe.jpg | Public | N/A |
thumbnail_1080_url
thumbnail_1080_urlURL of this playlist’s first video’s thumbnail image (1080px height).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s2.dmcdn.net/CTrg1/x1080-Ec7.jpg | Public | N/A |
thumbnail_url
thumbnail_urlURL of the thumbnail of this playlist’s first video (raw, respecting full size ratio).
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | https://s1.dmcdn.net/3CQ3.jpg | Public | N/A |
updated_time
updated_timeDate and time when this playlist was last updated.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 1404129540 | Public | N/A |
videos_total
videos_totalTotal amount of videos in this playlist.
| Type | Sample value | Read access (scope) | Write access (scope) |
|---|---|---|---|
| url | 14 | Public | N/A |