Music API

Search and download from the Hep.gg high-quality music library by ISRC, plus a unified downloader for YouTube, SoundCloud, Instagram, TikTok, and Facebook, with cached streaming and artwork.

Music API#

The Hep.gg Music API (Music Prime) has two halves. The high-quality music library resolves tracks by ISRC and returns lossless or high-bitrate audio, with live search and cover artwork. The unified downloader takes any YouTube, SoundCloud, Instagram, TikTok, or Facebook link and returns audio or video (YouTube Shorts and Reels included). Every call is authenticated with an API key you mint in the dashboard.

Authentication#

There is no public "create a key" endpoint. Keys are minted in the Hep.gg dashboard under the Music app (after your account is approved for it). Once you have a key, send it on each request using whichever of the three methods is convenient:

# query param
GET /search?q=...&key=<your-key>

# Authorization header - RAW key, NOT "Bearer <key>"
Authorization: <your-key>

# X-API-Key header
X-API-Key: <your-key>

Precedence, if you somehow send more than one, is: key query param, then Authorization, then X-API-Key. Three endpoints need no key at all: GET / (global stats), GET /artwork/:isrc (cover art), and GET /client (the desktop app download). Everything else requires a key.

Auth errors#

Quickstart#

Download a single track from the library by ISRC. The default quality is 128; pass quality=320 for HQ.

curl -L "https://music.jakeypri.me/download?isrc=USRC17607839&quality=320&key=YOUR_KEY" \
  -o track.mp3

const res = await fetch(
  "https://music.jakeypri.me/download?isrc=USRC17607839&quality=320",
  { headers: { "X-API-Key": "YOUR_KEY" } }
);
if (!res.ok) throw new Error(`Download failed: ${res.status}`);
 
const buf = Buffer.from(await res.arrayBuffer());
await require("fs/promises").writeFile("track.mp3", buf);

Endpoints#

Error model#

Errors are returned as a JSON envelope with an error string. Some routes add a hint or details field when it helps you fix the request.

{ "error": "Invalid ISRC. Must be 12 characters." }

Rate limits and quotas#

There is no published public rate limit or quota. Hep.gg keeps per-key usage counters (downloads broken down by network, plus library pulls and searches) which are visible in the dashboard. Be a good neighbor: cache results you reuse, and note that HQ library downloads are already cached server-side for 24 hours.