cobalt API Documentation

This document provides info about methods and acceptable variables for all cobalt API requests.

POST: `/api/json`

Main processing endpoint.

Request Body Type: application/json
Response Body Type: application/json

key	type	variables	default	description
url	string	Sharable URL encoded as URI	`null`	Must be included in every request.
vCodec	string	`h264 / av1 / vp9`	`h264`	Applies only to YouTube downloads. `h264` is recommended for phones.
vQuality	string	`144 / ... / 2160 / max`	`720`	`720` quality is recommended for phones.
aFormat	string	`best / mp3 / ogg / wav / opus`	`mp3`
isAudioOnly	boolean	`true / false`	`false`
isNoTTWatermark	boolean	`true / false`	`false`	Changes whether downloaded TikTok & Douyin videos have watermarks.
isTTFullAudio	boolean	`true / false`	`false`	Enables download of original sound used in a TikTok video.
isAudioMuted	boolean	`true / false`	`false`	Disables audio track in video downloads.
dubLang	boolean	`true / false`	`false`	Backend uses Accept-Language for YouTube video audio tracks when `true`.

key	type	variables
status	string	`error / redirect / stream / success / rate-limit / picker`
text	string	Text
url	string	Direct link to a file / link to cobalt's stream
pickerType	string	`various / images`
picker	array	Array of picker items
audio	string	Direct link to a file / link to cobalt's stream

Item type: object

key	type	variables	description
type	string	`video`	Used only if `pickerType` is `various`.
url	string	Direct link to a file / link to cobalt's stream
thumb	string	Item thumbnail that's displayed in the picker	Used only for `video` type.

Content live render streaming endpoint.

key	variables	description
p	`1`	Used for checking the rate limit.
t	Stream token	Unique stream identificator which is used for retrieving cached stream info data.
h	HMAC	Hashed combination of: (hashed) ip address, stream token, expiry timestamp, and service name. Used for verification of stream.
e	Expiry timestamp

On-demand website element loading. Currently used only for older changelogs.

key	variables	description
blockId	`0`	Block ID to be rendered on the server.

key	type	variables
status	string	`error / success`
text	string	Error text or rendered block