Openwhyd API

Base URL

https://openwhyd.org

Authentication

No API key for public feeds and playlists. A session cookie is needed only to post or modify tracks.

Rate limit

No published limit. It is a small community-run open-source project — keep request volumes low.

Pricing

Free. Openwhyd is open source and non-commercial.

CORS

Not enabled — call it from your server

Official docs

Read the docs

Every request below was executed against the live API on 21 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://openwhyd.org/hot/electro?format=json&limit=1'

const res = await fetch("https://openwhyd.org/hot/electro?format=json&limit=1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://openwhyd.org/hot/electro?format=json&limit=1", timeout=20)
res.raise_for_status()
print(res.json())

{
  "hasMore": {
    "skip": 1
  },
  "tracks": [
    {
      "_id": "6a7f6fbf394b6d8102cbdadc",
      "eId": "/yt/v_tS20htL1w",
      "name": " Lip Lift - battlefield",
      "img": "https://i.ytimg.com/vi/v_tS20htL1w/hqdefault.jpg",
      "uId": "5911f8e098267ba4b34b8424",
      "uNm": "ROBIT",
      "pl": {
        "id": 329,
        "name": "Indie, pop, alternative, new wave 298"
      },
      "pId": "6a7f6fbf394b6d8102cbdadc",
      "nbR": 5,
      "nbL": 3,
      "score": 8,
      "trackUrl": "//youtube.com/watch?v=v_tS20htL1w"
    }
  ]
}

tracksarray

The curated tracks, ranked by score.

tracks[].namestring

Track title as entered by the curator. Formatting is inconsistent — leading spaces and mixed conventions are common.

tracks[].eIdstring

External identifier encoding source and id together, as in `/yt/VIDEOID` for YouTube. Parse this to choose the right player.

tracks[].trackUrlstring

Protocol-relative URL to the source, beginning `//`. Prefix `https:` before using it.

tracks[].imgstring

Thumbnail from the source platform.

tracks[].uId / uNmstring

Id and display name of the curator who added the track.

tracks[].plobject

The playlist it belongs to, with the playlist's own `id` and `name`.

tracks[].nbR / nbLinteger

Repost and like counts.

tracks[].scoreinteger

Ranking score combining the engagement counters — what the hot feed sorts on.

hasMore.skipinteger

Offset to send as `skip` for the next page. Absent when there is nothing more.

• Surface human-curated music by genre instead of algorithmic recommendations
• Build a cross-platform player that routes to YouTube or SoundCloud from one feed
• Track which curators are driving discovery in a genre
• Seed a radio-style queue from community picks

If Openwhyd does not fit, these music apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.