d87613a1fd
tiktok replaced uploader's username in watermark with some corny shit like "Laughter awaits", making watermarks absolutely useless instead of this feature the uploader's username is now always in the filename
76 lines
5 KiB
Markdown
76 lines
5 KiB
Markdown
# cobalt api documentation
|
|
this document provides info about methods and acceptable variables for all cobalt api requests.
|
|
|
|
```
|
|
👍 you can use co.wuk.sh instance in your projects for free, just don't be an asshole.
|
|
```
|
|
|
|
## POST: `/api/json`
|
|
cobalt's main processing endpoint.
|
|
|
|
request body type: `application/json`
|
|
response body type: `application/json`
|
|
|
|
```
|
|
⚠️ you must include Accept and Content-Type headers with every POST /api/json request.
|
|
|
|
Accept: application/json
|
|
Content-Type: application/json
|
|
```
|
|
|
|
### request body variables
|
|
| key | type | variables | default | description |
|
|
|:------------------|:----------|:-----------------------------------|:----------|:--------------------------------------------------------------------------------|
|
|
| `url` | `string` | 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` | |
|
|
| `filenamePattern` | `string` | `classic / pretty / basic / nerdy` | `classic` | changes the way files are named. previews can be seen in the web app. |
|
|
| `isAudioOnly` | `boolean` | `true / false` | `false` | |
|
|
| `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 header for youtube video audio tracks when `true`. |
|
|
| `disableMetadata` | `boolean` | `true / false` | `false` | disables file metadata when set to `true`. |
|
|
| `twitterGif` | `boolean` | `true / false` | `false` | changes whether twitter gifs are converted to .gif |
|
|
|
|
### response body variables
|
|
| key | type | variables |
|
|
|:-------------|:---------|:------------------------------------------------------------|
|
|
| `status` | `string` | `error / redirect / stream / success / rate-limit / picker` |
|
|
| `text` | `string` | various text, mostly used for errors |
|
|
| `url` | `string` | direct link to a file or a link to cobalt's live render |
|
|
| `pickerType` | `string` | `various / images` |
|
|
| `picker` | `array` | array of picker items |
|
|
| `audio` | `string` | direct link to a file or a link to cobalt's live render |
|
|
|
|
### picker item variables
|
|
item type: `object`
|
|
|
|
| key | type | variables | description |
|
|
|:--------|:---------|:--------------------------------------------------------|:---------------------------------------|
|
|
| `type` | `string` | `video` | used only if `pickerType`is `various`. |
|
|
| `url` | `string` | direct link to a file or a link to cobalt's live render | |
|
|
| `thumb` | `string` | item thumbnail that's displayed in the picker | used only for `video` type. |
|
|
|
|
## GET: `/api/stream`
|
|
cobalt's live render (or stream) endpoint. usually, you will receive a url to this endpoint
|
|
from a successful call to `/api/json`. however, the parameters passed to it are **opaque**
|
|
and **unmodifiable** from your (the api client's) perspective, and can change between versions.
|
|
|
|
therefore you don't need to worry about what they mean - but if you really want to know, you can
|
|
[read the source code](../src/modules/stream/manage.js).
|
|
|
|
## GET: `/api/serverInfo`
|
|
returns current basic server info.
|
|
response body type: `application/json`
|
|
|
|
### response body variables
|
|
| key | type | variables |
|
|
|:------------|:---------|:------------------|
|
|
| `version` | `string` | cobalt version |
|
|
| `commit` | `string` | git commit |
|
|
| `branch` | `string` | git branch |
|
|
| `name` | `string` | server name |
|
|
| `url` | `string` | server url |
|
|
| `cors` | `int` | cors status |
|
|
| `startTime` | `string` | server start time |
|