Updated API (markdown)

This commit is contained in:
Omar Roth 2019-03-31 22:44:35 -05:00 committed by Perflyst
parent cd2643abe2
commit 3608b45178

28
API.md
View File

@ -143,6 +143,16 @@ Parameters:
region: ISO 3166 country code (default: "US") region: ISO 3166 country code (default: "US")
``` ```
##### GET `/api/v1/annotations/:id`
Parameters:
```
source: "archive", "youtube" (default: "archive")
```
Returns annotation XML from YouTube's `/annotations_invideo` endpoint. Alternatively it provides access to legacy annotation data using [this collection](https://archive.org/details/youtubeannotations) on archive.org.
##### GET `/api/v1/comments/:id` ##### GET `/api/v1/comments/:id`
> Schema: > Schema:
@ -192,7 +202,7 @@ continuation: String
##### GET `/api/v1/insights/:id` ##### GET `/api/v1/insights/:id`
**Will always return 510: `YouTube has removed publicly-available analytics`*** **Will always return 510: `YouTube has removed publicly-available analytics`\***
> Schema: > Schema:
@ -552,10 +562,10 @@ sort_by: "oldest", "newest", "last"
videoCount: Int32, videoCount: Int32,
videos: [ videos: [
{ {
"title": String, title: String,
"videoId": String, videoId: String,
"lengthSeconds": Int32, lengthSeconds: Int32,
"videoThumbnails": [ videoThumbnails: [
{ {
quality: String, quality: String,
url: String, url: String,
@ -636,10 +646,10 @@ page: Int32
videoCount: Int32, videoCount: Int32,
videos: [ videos: [
{ {
"title": String, title: String,
"videoId": String, videoId: String,
"lengthSeconds": Int32, lengthSeconds: Int32,
"videoThumbnails": [ videoThumbnails: [
{ {
quality: String, quality: String,
url: String, url: String,