Skip to main content

API

MediaFetch exposes a tiny API used by the UI.

Health​

GET /api/health

Returns a simple health response.

Start a fetch​

POST /api/fetch

Starts a download job and streams logs via Server-Sent Events (SSE).

Example request body:

{
  "url": "https://example.com/video",
  "mode": "video | audio",
  "filename": "optional-custom-name"
}

If Basic Auth is enabled, the API is protected with the same credentials as the UI.