From c98b0eb120744e75cf448f91ebe18f9fff76e1e2 Mon Sep 17 00:00:00 2001 From: SmilerRyan Date: Mon, 2 Sep 2024 05:06:16 +0100 Subject: [PATCH] docs/api: Add /api/best_audio route information --- docs/api.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/api.md b/docs/api.md index 6cd66bba..e1e98786 100644 --- a/docs/api.md +++ b/docs/api.md @@ -53,6 +53,13 @@ item type: `object` | `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 for `video` and `gif` types | +## GET: `/api/best_audio` +cobalt's best audio endpoint. this endpoint purely fetches the best audio available in any format without re-encoding, and redirects you to the download URL for the audio file. The query paramater `url` is required. + +``` +⚠️ Ensure that the `url` parameter is properly encoded before making the request. +``` + ## 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**