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

Request
// ⚠️ 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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →