Openwhyd API

⭐ Beginner's Pick Music / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

Overview

Openwhyd is an open-source music curation platform that lets users bookmark and share streaming tracks from YouTube, SoundCloud, and other sources. Its API lets you access public playlists and track data without authentication. It's a lightweight starting point for building music playlist apps.

💡

Beginner Tip

The API returns JSON by default; use the /stream endpoint to get a user's recent track posts and explore curated playlists without needing any credentials.

Available Data

track name and artist
album metadata
audio preview URLs
popularity score
genre classification

Example Response

JSON Response
{
  "name": "Bohemian Rhapsody",
  "artist": "Queen",
  "album": "A Night at the Opera",
  "duration_ms": 354000,
  "popularity": 92,
  "preview_url": "https://p.scdn.co/mp3-preview/..."
}

Field Reference

_id Unique identifier for the track post.
name Title or description of the track as saved by the user.
eId External track identifier including the source prefix (e.g., "/yt/" for YouTube, "/sc/" for SoundCloud).
uId User ID of the person who posted the track.
pl Playlist object containing the playlist ID and name.
img URL to the track's thumbnail image.

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://openwhyd.github.io/openwhyd/API";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Empty posts array The user ID or playlist ID is incorrect, or the playlist has no tracks.
Browse openwhyd.org to find valid user IDs and playlist numbers before making API calls.
CORS errors in the browser The API does not support cross-origin requests from browsers.
Call the Openwhyd API from a server-side script (Node.js, Python, etc.) instead of directly from a browser.
Unexpected HTML response Missing the ?format=json query parameter.
Always append ?format=json to your request URL to receive JSON instead of an HTML page.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 41ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS NO
Category Music
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →