Docs

A quick overview of the ArtistBots API: what it offers and which endpoints exist.

Overview

ArtistBots is a simple HTTP API that gives your app or Telegram bot audio and video downloads from YouTube links, bare YouTube video IDs and Spotify track links. You can also look a song up by its title.

Audio and video, with a selectable maximum video quality
Works with any language or framework that can make an HTTP GET request
One personal API key, used with whichever plan is active
Every plan has a daily request limit (audio and video share it)

Endpoints

Endpoint	What it does
GET `/download`	Returns the audio or video file as a downloadable attachment.
GET `/stream`	Plays directly inline in the browser (player with seeking). Add `&format=json` for a JSON link instead.

Both endpoints need an API key. The parameters, request and response examples, error codes and the Telegram bot guide are in the full docs after you sign in.

Full API reference for signed-in users

Sign in (it's free) to get your API key and open the complete documentation with the base URL, parameters, examples and error codes.