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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

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

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative
{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request
const url = "https://openwhyd.org/u/55d5e81de0c28b9818e20ca8/playlist/0?format=json&limit=10";
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

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

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
Listing details not endpoint-verified

Related Tags

Similar APIs

View All →