← MultiMP3 product pageA ChudGPT App · Developer reference

Build with the MultiMP3 API.

A public, credential-free API for browser apps on any origin, command-line tools, desktop and mobile applications, server programs, and automation tools. Processing happens on demand and may take time.

Check API health ↗Full GitHub API guide ↗Open MultiMP3 Web ↗
Endpoint reference

Four public routes.

Base URL: https://multimp3.vercel.app/api. No API key is currently required, cross-origin browser requests are allowed, and the service applies a 40-request-per-minute limit.

GEThttps://multimp3.vercel.app/api/health

Check processing-service and dependency health.

Response: JSON service and dependency health
POSThttps://multimp3.vercel.app/api/info

Read public metadata for supported URLs before downloading.

urlsrequiredArray of 1–50 supported HTTPS URLs
Response: JSON: { "items": [...] }
POSThttps://multimp3.vercel.app/api/download

Process and return one permitted track as an MP3 attachment.

urlrequiredSupported HTTPS YouTube URL
titleoptionalDownload title; defaults to track
qualityoptional128, 192, 256, 320, or best
Response: audio/mpeg MP3 attachment
POSThttps://multimp3.vercel.app/api/export

Create an organized album ZIP or complete site-albums ZIP.

albumsrequired1–50 albums containing 1–250 total tracks
qualityoptional128, 192, 256, 320, or best
filenameoptionalRequested ZIP filename
Response: ZIP attachment
Metadata requestPOST /api/info
{
  "urls": [
    "https://www.youtube.com/watch?v=VIDEO_ID"
  ]
}
Track download requestPOST /api/download
{
  "url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "title": "Example Track",
  "quality": "192"
}
Album export requestPOST /api/export
{
  "quality": "320",
  "filename": "My_Album.zip",
  "albums": [{
    "name": "My Album",
    "tracks": [{
      "title": "Example Track",
      "url": "https://www.youtube.com/watch?v=VIDEO_ID"
    }]
  }]
}
Validation and limits

Know the boundaries.

Errors return JSON containing an error string. Always inspect the HTTP status before parsing a success response or saving a returned file.

Supported URLs

URL fields must use HTTPS and a supported YouTube host. /api/info accepts 1–50 URLs.

Download quality

Use 128, 192, 256, 320, or best. Downloads return MP3 attachments.

Export size

Export 1–50 albums containing 1–250 total tracks. Successful exports return ZIP attachments.

Rate limit

The current service limit is 40 requests per minute. Back off and retry later when rate-limited.

On-demand work

Metadata extraction, conversion, and ZIP creation run on demand and may take time. Use practical timeouts.

Availability

The separately operated processing service may be temporarily unavailable. Handle non-200 responses and invalid responses safely.

Basic usage

From health check to ZIP.

Use the smallest route that fits the job and validate every response before proceeding.

  1. 1

    Check /api/health.

  2. 2

    Send supported URLs to /api/info.

  3. 3

    Select a supported quality.

  4. 4

    Send one permitted track to /api/download.

  5. 5

    Use /api/export for organized album ZIP files.

  6. 6

    Handle non-200 responses and rate limits.

Working examples

Choose your language.

Use the arrow keys, Home, or End to move between tabs. Every example calls the stable public multimp3.vercel.app/api URL.

cURLPOST /api/info
curl -X POST "https://multimp3.vercel.app/api/info" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.youtube.com/watch?v=VIDEO_ID"]}'
Read full source guide ↗View MultiMP3 source ↗Return to MultiMP3