Saved playlists

Saved playlists belong to an API account. They hold source links rather than stored copies of the media. Each account can create 5 playlists with 50 items per playlist.

Playlist routes

All writes require the owner. GET /playlists lists the caller's playlists. Reads of a specific public or unlisted playlist do not require authentication; private reads require the owner.

name is trimmed and must contain 1 to 100 characters. description is at most 1000 characters. An update must contain at least one allowed field. Unknown fields are rejected.

Visibility

Sharing does not grant editing rights or permission to download as the owner. Use GET /playlists/public?limit=20 for the public listing. limit is 1 to 50; pass the returned nextCursor as cursor for the next page when present.

Item routes

An add request contains 1 to 50 item objects and must fit the playlist's remaining capacity. Each URL is HTTP(S), up to 4096 characters, without embedded credentials. title is optional, up to 200 characters. mediaType is auto (default), video, audio, or image.

Download selected links

POST /playlists/:id/download requires the owner. Use the actual item IDs returned by the playlist, not media URLs or file IDs.

{
    "itemIds": [
        "pli_example"
    ],
    "output": {
        "type": "auto",
        "format": "original",
        "quality": "best"
    }
}

Select 1 to 10 unique item IDs. output is optional. The response is 202 with a batch; follow batch status. This does not download files immediately or create a ZIP.

If you use a single partner key for your bot, these are your partner account's playlists. They are not automatically separated by Discord member.

Request examples

Choose a language. JavaScript and Node.js examples use a server environment, not a public browser key. Replace illustrative IDs with your own.

Create a playlist

curl --fail-with-body -X POST 'https://api.mediafilez.online/api/v1/playlists' \
    -H "Authorization: ApiKey $MEDIAFILEZ_API_KEY" \
    -H 'Content-Type: application/json' \
    --data '{
    "name": "Saved",
    "visibility": "private"
}'

Update a playlist

curl --fail-with-body -X PATCH 'https://api.mediafilez.online/api/v1/playlists/pl_example' \
    -H "Authorization: ApiKey $MEDIAFILEZ_API_KEY" \
    -H 'Content-Type: application/json' \
    --data '{
    "name": "Updated name",
    "visibility": "unlisted"
}'

Add source links

curl --fail-with-body -X POST 'https://api.mediafilez.online/api/v1/playlists/pl_example/items' \
    -H "Authorization: ApiKey $MEDIAFILEZ_API_KEY" \
    -H 'Content-Type: application/json' \
    --data '{
    "items": [
        {
            "url": "https://example.com/video.mp4",
            "mediaType": "video"
        }
    ]
}'

Delete a playlist

curl --fail-with-body -X DELETE 'https://api.mediafilez.online/api/v1/playlists/pl_example' \
    -H "Authorization: ApiKey $MEDIAFILEZ_API_KEY"