documentation/API.md

618 lines
10 KiB
Markdown
Raw Normal View History

2018-08-05 17:19:59 +00:00
##### GET `/api/v1/videos/:id`
2018-09-28 15:58:34 +00:00
> Schema:
```javascript
2018-08-05 17:07:48 +00:00
{
"title": String,
"videoId": String,
"videoThumbnails": [
2018-09-28 15:58:34 +00:00
{
2018-08-05 17:07:48 +00:00
"quality": String,
"url": String,
"width": Int32,
"height": Int32
},
],
"description": String,
"descriptionHtml": String,
2018-09-28 15:48:24 +00:00
"published": Int64,
"publishedText": String,
2018-09-28 15:58:34 +00:00
2018-08-05 17:07:48 +00:00
"keywords": Array(String),
"viewCount": Int64,
"likeCount": Int32,
"dislikeCount": Int32,
2018-09-28 15:58:34 +00:00
2018-11-05 01:00:02 +00:00
"paid": Bool,
"premium": Bool,
2018-08-05 17:07:48 +00:00
"isFamilyFriendly": Bool,
"allowedRegions": Array(String),
"genre": String,
2018-09-28 15:48:24 +00:00
"genreUrl": String,
2018-09-28 15:58:34 +00:00
2018-08-05 17:07:48 +00:00
"author": String,
"authorId": String,
"authorUrl": String,
2018-11-05 01:00:02 +00:00
"authorThumbnails": [
{
"url": String,
"width": Int32,
"height": Int32
}
],
2018-08-05 17:07:48 +00:00
2018-11-05 01:00:02 +00:00
"subCountText": String,
2018-08-05 17:07:48 +00:00
"lengthSeconds": Int32,
"allowRatings": Bool,
"rating": Float32,
2018-11-05 01:00:02 +00:00
"isListed": Bool?,
2018-08-07 19:37:58 +00:00
"hlsUrl": String?,
2018-08-05 17:07:48 +00:00
"adaptiveFormats": [
{
"index": String,
"bitrate": String,
"init": String,
"url": String,
"itag": String,
"type": String,
"clen": String,
"lmt": String,
"projectionType": Int32,
"container": String,
"encoding": String,
"qualityLabel": String?,
"resolution": String?
},
],
"formatStreams": [
{
"url": String,
"itag": String,
"type": String,
"quality": String,
"container": String,
"encoding": String,
"qualityLabel": String,
"resolution": String,
"size": String
2018-09-28 15:58:34 +00:00
},
2018-08-05 17:07:48 +00:00
],
"captions": [
{
"label": String,
2018-09-28 15:48:24 +00:00
"languageCode": String,
"url": String,
2018-08-05 17:07:48 +00:00
},
],
"recommendedVideos": [
{
"videoId": String,
"title": String,
"videoThumbnails": [
{
"quality": String,
"url": String,
"width": Int32,
"height": Int32
},
],
"author": String,
"lengthSeconds": Int32,
"viewCountText" String
}
]
}
```
2018-09-28 15:58:34 +00:00
##### GET `/api/v1/comments/:id`
> Schema:
```javascript
{
"commentCount": Int32?,
"comments": [
{
"author": String,
"authorThumbnails": [
"url": String,
"width": Int32,
"height": Int32
],
"authorId": String,
"authorUrl": String,
"content": String,
"contentHtml": String,
"published": Int64,
"publishedText": String,
"likeCount": Int32,
"commentId": String,
"replies": {
"replyCount": Int32,
"continuation": String
}?
}
],
"continuation": String?
}
```
Parameters:
```
continuation: String
```
2018-09-28 16:00:38 +00:00
##### GET `/api/v1/insights/:id`
> Schema:
```javascript
{
"viewCount": Int64,
"timeWatchedText": String,
"subscriptionsDriven": Int32,
"shares": Int32,
"avgViewDurationSeconds": Int32,
"graphData": {
...
}
}
```
2018-09-28 15:58:34 +00:00
##### GET `/api/v1/captions/:id`
> Schema:
```javascript
{
"captions": [
{
"label": String,
"languageCode": String,
"url": String
}
]
}
```
Parameters:
```
label: String
2018-11-05 01:00:02 +00:00
lang: String
tlang: String
2018-09-28 15:58:34 +00:00
```
A request with `label` will return the selected captions in WebVTT format.
2018-11-05 01:00:02 +00:00
Captions can also be selected with an ISO `lang`, e.g. &lang=en, `tlang` will auto-translate from English into the requested language (if English captions are available).
2018-09-28 15:58:34 +00:00
2018-08-05 17:19:59 +00:00
##### GET `/api/v1/trending`
2018-09-28 15:58:34 +00:00
2018-08-05 17:19:59 +00:00
> Schema:
2018-09-28 15:58:34 +00:00
2018-08-05 17:19:59 +00:00
```
2018-08-05 17:30:33 +00:00
[
{
"title": String,
"videoId": String,
"videoThumbnails": [
{
"quality": String,
"url": String,
"width": Int32,
"height" Int32
],
"lengthSeconds": Int32,
"viewCount": Int64,
"author": String,
2018-09-28 15:48:24 +00:00
"authorId": String,
2018-08-05 17:30:33 +00:00
"authorUrl": String,
2018-08-05 17:31:51 +00:00
"published": Int64,
2018-09-28 15:48:24 +00:00
"publishedText": String,
2018-08-05 17:30:33 +00:00
"description": String,
"descriptionHtml": String
}
]
2018-08-05 17:19:59 +00:00
```
2018-08-05 17:07:48 +00:00
2018-08-05 17:36:55 +00:00
##### GET `/api/v1/top`
2018-09-28 15:58:34 +00:00
2018-08-05 17:36:55 +00:00
> Schema:
2018-09-28 15:58:34 +00:00
2018-08-05 17:36:55 +00:00
```
2018-08-07 19:37:58 +00:00
[
{
"title": String,
"videoId": String,
"videoThumbnails": [
{
"quality": String,
"url": String,
"width": Int32,
"height" Int32
],
"lengthSeconds": Int32,
"viewCount": Int64,
"author": String,
2018-09-28 15:48:24 +00:00
"authorId": String,
2018-08-07 19:37:58 +00:00
"authorUrl": String,
"published": Int64,
2018-09-28 15:48:24 +00:00
"publishedText": String,
2018-08-07 19:37:58 +00:00
"description": String,
"descriptionHtml": String
}
]
2018-08-05 17:36:55 +00:00
```
2018-08-05 17:07:48 +00:00
2018-08-05 17:36:55 +00:00
##### GET `/api/v1/channels/:ucid`
2018-09-28 15:58:34 +00:00
2018-08-05 17:36:55 +00:00
> Schema:
2018-09-28 15:58:34 +00:00
2018-08-05 17:36:55 +00:00
```
2018-08-07 19:37:58 +00:00
{
"author": String,
"authorId": String,
"authorUrl": String,
"authorBanners": [
{
"url": String,
"width": Int32,
"height": Int32
}
],
"authorThumbnails": [
{
"url": String,
"width": Int32,
"height": Int32
}
],
2018-09-28 15:58:34 +00:00
2018-08-07 19:37:58 +00:00
"subCount": Int32,
"totalViews": Int64,
"joined": Int64,
"paid": Bool,
"isFamilyFriendly": Bool,
"description": String,
2018-09-28 15:48:24 +00:00
"descriptionHtml": String,
2018-08-07 19:37:58 +00:00
"allowedRegions": Array(String),
"latestVideos": [
{
"title": String,
"videoId": String,
2018-09-28 15:48:24 +00:00
"author": String,
"authorId": String,
"authorUrl": String,
2018-08-07 19:37:58 +00:00
"videoThumbnails": [
{
"quality": String,
"url": String,
"width": Int32,
"height": Int32
}
2018-09-28 15:48:24 +00:00
],
"description": String,
"descriptionHtml": String,
"viewCount": Int64,
"published": Int64,
"publishedText": String,
2018-11-05 01:00:02 +00:00
"lengthSeconds": Int32,
"paid": Bool,
"premium": Bool
2018-08-07 19:37:58 +00:00
}
]
}
2018-08-05 17:36:55 +00:00
```
2018-08-05 17:07:48 +00:00
2018-11-05 01:00:02 +00:00
Note that a channel's username (if it doesn't include spaces) is also valid in place of `ucid`, e.g. `/api/v1/channels/BlenderFoundation`.
2018-09-28 15:49:08 +00:00
##### GET `/api/v1/channels/:ucid/videos`, `/api/v1/channels/videos/:ucid`
2018-09-28 15:58:34 +00:00
2018-08-05 17:36:55 +00:00
> Schema:
2018-09-28 15:58:34 +00:00
```javascript
2018-08-07 19:41:28 +00:00
[
{
2018-09-28 15:58:34 +00:00
title: String,
videoId: String,
author: String,
authorId: String,
authorUrl: String,
2018-09-28 15:48:24 +00:00
2018-09-28 15:58:34 +00:00
videoThumbnails: [
2018-08-07 19:41:28 +00:00
{
2018-09-28 15:58:34 +00:00
quality: String,
url: String,
width: Int32,
height: Int32
2018-08-07 19:41:28 +00:00
}
],
2018-09-28 15:58:34 +00:00
description: String,
descriptionHtml: String,
2018-08-07 19:57:58 +00:00
2018-09-28 15:58:34 +00:00
viewCount: Int64,
published: Int64,
publishedText: String,
lengthSeconds: Int32
2018-11-05 01:00:02 +00:00
paid: Bool,
premium: Bool
2018-08-07 19:41:28 +00:00
}
2018-09-28 15:58:34 +00:00
];
2018-08-05 17:36:55 +00:00
```
2018-08-05 17:07:48 +00:00
2018-08-08 15:36:46 +00:00
Parameters:
2018-09-28 15:58:34 +00:00
2018-08-08 15:36:46 +00:00
```
page: Int32
```
2018-09-28 15:58:34 +00:00
##### GET `/api/v1/channels/search/:ucid`
2018-08-05 17:36:55 +00:00
> Schema:
2018-09-28 15:58:34 +00:00
```javascript
[
{
type: "video",
title: String,
videoId: String,
author: String,
authorId: String,
authorUrl: String,
videoThumbnails: [
{
quality: String,
url: String,
width: Int32,
height: Int32
}
],
description: String,
descriptionHtml: String,
viewCount: Int64,
published: Int64,
publishedText: String,
lengthSeconds: Int32,
2018-11-05 01:00:02 +00:00
liveNow: Bool,
paid: Bool,
premium: Bool
2018-09-28 15:58:34 +00:00
},
{
type: "playlist",
title: String,
playlistId: String,
author: String,
authorId: String,
authorUrl: String,
videoCount: Int32,
videos: [
2018-09-29 00:19:15 +00:00
{
"title": String,
"videoId": String,
"lengthSeconds": Int32,
"videoThumbnails": [
{
quality: String,
url: String,
width: Int32,
height: Int32
}
]
}
2018-09-28 15:58:34 +00:00
]
},
{
type: "channel",
author: String,
authorId: String,
authorUrl: String,
authorThumbnails: [
{
url: String,
width: Int32,
height: Int32
}
],
subCount: Int32,
videoCount: Int32,
description: String,
descriptionHtml: String
}
];
```
Parameters:
2018-08-05 17:36:55 +00:00
```
2018-09-28 15:58:34 +00:00
q: String
page: Int32
```
##### GET `/api/v1/search`
> Schema:
```javascript
2018-08-07 19:45:21 +00:00
[
{
2018-09-28 15:58:34 +00:00
type: "video",
title: String,
videoId: String,
author: String,
authorId: String,
authorUrl: String,
videoThumbnails: [
2018-08-07 19:45:21 +00:00
{
2018-09-28 15:58:34 +00:00
quality: String,
url: String,
width: Int32,
height: Int32
2018-08-07 19:45:21 +00:00
}
],
2018-09-28 15:58:34 +00:00
description: String,
descriptionHtml: String,
viewCount: Int64,
published: Int64,
publishedText: String,
lengthSeconds: Int32,
2018-11-05 01:00:02 +00:00
liveNow: Bool,
paid: Bool,
premium: Bool
2018-09-28 15:48:24 +00:00
},
{
2018-09-28 15:58:34 +00:00
type: "playlist",
title: String,
playlistId: String,
author: String,
authorId: String,
authorUrl: String,
videoCount: Int32,
videos: [
2018-09-29 00:19:15 +00:00
{
"title": String,
"videoId": String,
"lengthSeconds": Int32,
"videoThumbnails": [
{
quality: String,
url: String,
width: Int32,
height: Int32
}
]
}
2018-09-28 15:48:24 +00:00
]
},
{
2018-09-28 15:58:34 +00:00
type: "channel",
author: String,
authorId: String,
authorUrl: String,
2018-09-28 15:48:24 +00:00
2018-09-28 15:58:34 +00:00
authorThumbnails: [
2018-09-28 15:48:24 +00:00
{
2018-09-28 15:58:34 +00:00
url: String,
width: Int32,
height: Int32
2018-09-28 15:48:24 +00:00
}
],
2018-09-28 15:58:34 +00:00
subCount: Int32,
videoCount: Int32,
description: String,
descriptionHtml: String
2018-08-07 19:45:21 +00:00
}
2018-09-28 15:58:34 +00:00
];
2018-08-05 17:36:55 +00:00
```
2018-08-07 19:57:58 +00:00
2018-09-28 15:58:34 +00:00
Parameters:
2018-08-08 15:36:46 +00:00
```
2018-09-28 15:58:34 +00:00
q: String
page: Int32
2018-08-08 15:36:46 +00:00
sort_by: "relevance", "rating", "upload_date", "view_count"
date: "hour", "today", "week", "month", "year"
duration: "short", "long"
2018-09-28 15:48:24 +00:00
type: "video", "playlist", "channel", "all", (default: video)
2018-08-08 15:36:46 +00:00
```
2018-09-28 15:58:34 +00:00
##### GET `/api/v1/playlists/:plid`
2018-08-07 19:57:58 +00:00
> Schema:
2018-09-28 15:58:34 +00:00
```javascript
{
"title": String,
"playlistId": String,
2018-08-08 15:36:46 +00:00
2018-09-28 15:58:34 +00:00
"author": String,
"authorId": String,
"authorThumbnails": [
{
"url": String,
"width": String,
"height": String
}
],
"description": String,
"descriptionHtml": String,
2018-08-08 15:36:46 +00:00
2018-09-28 15:58:34 +00:00
"videoCount": Int32,
"viewCount": Int64,
"updated": Int64,
2018-08-08 15:36:46 +00:00
2018-09-28 15:58:34 +00:00
"videos": [
2018-09-29 00:19:15 +00:00
{
"title": String,
"videoId": String,
"author": String,
"authorId": String,
"authorUrl": String,
"videoThumbnails": [
{
"quality": String,
"url": String,
"width": Int32,
"height": Int32
}
],
"index": Int32,
"lengthSeconds": Int32
}
2018-09-28 15:58:34 +00:00
]
2018-08-07 19:57:58 +00:00
}
2018-08-08 15:36:46 +00:00
```
Parameters:
2018-09-28 15:58:34 +00:00
```
page: Int32
2018-08-08 15:36:46 +00:00
```
2018-11-05 01:00:02 +00:00
##### GET `/api/v1/mixes/:rdid`
> Schema:
```javascript
{
title: String,
mixId: String,
videos: [
{
title: String,
videoId: String,
author: String,
authorId: String,
authorUrl: String,
videoThumbnails: [
{
quality: String,
url: String,
width: Int32,
height: Int32
}
],
index: Int32,
lengthSeconds: Int32
}
]
}
```