/vidpolarisAPI

the api for the vidpolaris project

Primary LanguageJavaScript

vidpolarisAPI

the api for my vidpolaris project, based off of my old YTDL-API.

this is not affiliated in any way with google or youtube! use at your own risk

* = required parameter

if you try to load certain tests, depending on if youtube is rate-limiting us, it may not work.

sources

endpoints

api version, endpoints, etc.

http://[host]/

test this command

trending data (via invidious)

http://[host]/?trending=[region]&type=[type]

type: music, gaming, news, movies
country*: a country from this list -> https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

test this command (variation 1) => general trending list in the united states

test this command (variation 2) => music trending list in canada

get all information on a video (via node-ytdl-core)

http://[host]/?info=1&url=[url]

info*: 1
url*: video link (in https://youtube.com/watch?v= format)

test this command => streaming links and info of a test video

translate any given text (used for comments, via google-translate-api)

http://[host]/?translate=[text]&to=[language]

translate*: text
to: language from google translate's list, converted to ISO 639-1 format (defualt: en)

test this command (variation 1) => "hello world" to spanish

test this command (variation 2) => "hola mundo" to english

search videos (via TimeForANinja/ytsr)

http://[host]/?search=[query]

search*: give any query and it turns back out 10 or less results
type: video, playlist, channel

test this command (variation 1) => gives 10 results (or less) of videos that match "test video"

test this command (variation 2) => gives 10 results (or less) of results that match "test video"

search suggestions (via youtube-suggest)

http://vidpolaris.herokuapp.com/?suggest=[query]

suggest*: give any query and it gives you 10 or less suggestions

test this command => gives 10 results (or less) of search suggestions that match "test video"

video comments (via youtube-comment-api)

http://[host]/?comments=1&token=[token]&url=[url]

comments*: 1
url*: video link (in https://youtube.com/watch?v= format)
token: continuation after 20 comments, given in first response (if any)

test this command => gives 20 comments or less on the Robert Thicke song "Blurred Lines"

specific video itag (via node-ytdl-core)

http://[host]/?itag=[itag]&url=[url]

itag*: itag, found in smart response
url*: video link (in https://youtube.com/watch?v= format)

test this command => gives 480p itag of the Robert Thicke song "Blurred Lines"

channel information (via invidious)

http://[host]/?channelId=[id]

channelId*: youtube channel id

test this command => returns channel information for RobinThickeVevo

channel videos (via invidious)

http://[host]/?channelVideos=[id]

channelVideos*: youtube channel id
page: a number (default: 1)

test this command => returns channel videos of the channel RobinThickeVevo

search reddit for a video

http://[host]/?redditSearch=[id]

id*: ID of a youtube video

test this command => reddit posts containing a link for Robert Thicke song "Blurred Lines"

videos trending on reddit

http://[host]/?reddi=1&type=[sub]

reddit*: 1
sub: music, deep

if sub is not in there, it defaults to /r/videos.

test this command (variation 1) => videos trending on /r/videos

test this command (variation 2) => videos trending on /r/deepintoyoutube

playlists

http://[host]/?playlistId=[list]

list: playlist id

test this command