# Openwhyd

> Read Openwhyd, the free, open-source music curation community: hot tracks, a user's posted tracks and playlists, their profile, search across tracks, playlists and users, and any track with its comments. Tracks link to where they play (YouTube, SoundCloud, Bandcamp and more). No account or API key required.

App · 7 actions. Web page: https://docs.lodol.com/docs/integrations/openwhyd

## Actions

### Get track

Get one track posted on Openwhyd, with where to listen, its comments and who re-posted it. No API key required.

**Inputs**

- Track (`track_id`, text, required): The track's id from another Openwhyd step, or a link to it such as openwhyd.org/c/6accacfbb45ad085d09cf7be.

**Outputs**

- `comment` (text): What the poster wrote with it, with @mentions as @Name.
- `comment_count` (number): How many comments it has.
- `comments` (list): The comments on the track, oldest first.
- `embed_id` (text): Openwhyd's id for the source, e.g. '/yt/IoOhKb9YcLs'.
- `image_url` (text): The track's artwork or video thumbnail.
- `is_repost` (true/false): True when the poster re-posted someone else's post.
- `likes` (number): How many people liked it.
- `platform` (text): Where the music is hosted, e.g. 'YouTube', 'SoundCloud' or 'Bandcamp'.
- `playlist_name` (text): That playlist's name.
- `playlist_number` (number): The number of the poster's playlist it is in, if any.
- `plays` (number): How many times it was played on Openwhyd, when Openwhyd says.
- `posted_at` (text): When it was posted, ISO 8601 in UTC.
- `posted_by_id` (text): The id of the user who posted it.
- `posted_by_name` (text): The name of the user who posted it.
- `reposted_by` (list): The names of the people who re-posted it.
- `reposted_from_user_name` (text): For a repost, who posted it originally.
- `reposts` (number): How many times others re-posted it, when Openwhyd says.
- `source_url` (text): The track on that platform, to listen to it.
- `title` (text): The track as posted, usually 'Artist - Title'.
- `track_id` (text): Openwhyd's id for this post of the track.
- `url` (text): The track's page on Openwhyd.

**Example output**

```json
{
  "comment": null,
  "comment_count": 0,
  "comments": [],
  "embed_id": "/yt/IoOhKb9YcLs",
  "image_url": "https://i.ytimg.com/vi/IoOhKb9YcLs/hqdefault.jpg",
  "is_repost": false,
  "likes": 1,
  "platform": "YouTube",
  "playlist_name": "Indie, pop, alternative, new wave 303",
  "playlist_number": 334,
  "plays": 7,
  "posted_at": "2026-10-12T09:48:43Z",
  "posted_by_id": "5911f8e098267ba4b34b8424",
  "posted_by_name": "ROBIT",
  "reposted_by": [
    "Stefanos Mavrogenis",
    "Israel Lindenbaum"
  ],
  "reposted_from_user_name": null,
  "reposts": 2,
  "source_url": "https://www.youtube.com/watch?v=IoOhKb9YcLs",
  "title": "The 101ers - Silent Telephone (feat. Joe Strummer)",
  "track_id": "6accacfbb45ad085d09cf7be",
  "url": "https://openwhyd.org/c/6accacfbb45ad085d09cf7be"
}
```

### Get user

Get a user's public Openwhyd profile: name, bio, location, pictures, links and number of playlists. No API key required.

**Inputs**

- User (`user`, text, required): The Openwhyd username (as in openwhyd.org/adrien), the user's id, or a link to their profile.

**Outputs**

- `avatar_url` (text): Their profile picture.
- `bio` (text): What they say about themselves.
- `cover_image_url` (text): The banner image on their profile.
- `handle` (text): Their username, as in openwhyd.org/adrien, when they chose one.
- `links` (object): The links on their profile; each is empty when not set.
- `location` (text): Where they say they are.
- `name` (text): Their display name.
- `playlist_count` (number): How many playlists they have.
- `url` (text): Their profile on Openwhyd.
- `user_id` (text): The user's Openwhyd id.

**Example output**

```json
{
  "avatar_url": "https://secure.gravatar.com/avatar/abe56303903304bb666b0e47ca9d42fd?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Faj.png",
  "bio": "Picky but diverse: indie/post/angry rock, fusion jazz, synthwave, chiptune...\nAlso, I lead the development of openwhyd.org.",
  "cover_image_url": "https://openwhyd.org/uCoverImg/6664b7078abc88281847e617eb8d3e4a_960x.jpg",
  "handle": "adrien",
  "links": {
    "facebook": null,
    "instagram": null,
    "soundcloud": null,
    "twitter": "https://twitter.com/adrienjoly",
    "website": "https://adrienjoly.com/now",
    "youtube": null
  },
  "location": "Montreuil / Paris, France",
  "name": "Adrien Joly",
  "playlist_count": 64,
  "url": "https://openwhyd.org/adrien",
  "user_id": "4d94501d1f78ac091dbc9b4d"
}
```

### List hot tracks

List the tracks getting the most attention on Openwhyd right now, hottest first (up to 20), with where to listen to each. No API key required.

**Inputs**

- Number of tracks (`limit`, number): How many tracks to return, 1 to 20. Defaults to 20. From 1 to 20.

**Outputs**

- `count` (number): How many tracks came back.
- `tracks` (list): The hot tracks, hottest first.

**Example output**

```json
{
  "count": 1,
  "tracks": [
    {
      "comment": null,
      "embed_id": "/yt/IoOhKb9YcLs",
      "image_url": "https://i.ytimg.com/vi/IoOhKb9YcLs/hqdefault.jpg",
      "is_repost": false,
      "likes": 1,
      "platform": "YouTube",
      "playlist_name": "Indie, pop, alternative, new wave 303",
      "playlist_number": 334,
      "plays": null,
      "posted_at": "2026-10-12T09:48:43Z",
      "posted_by_id": "5911f8e098267ba4b34b8424",
      "posted_by_name": "ROBIT",
      "rank": 1,
      "reposted_from_user_name": null,
      "reposts": 5,
      "source_url": "https://www.youtube.com/watch?v=IoOhKb9YcLs",
      "title": "The 101ers - Silent Telephone (feat. Joe Strummer)",
      "track_id": "6accacfbb45ad085d09cf7be",
      "url": "https://openwhyd.org/c/6accacfbb45ad085d09cf7be"
    }
  ]
}
```

### List playlist tracks

List the tracks in one of a user's Openwhyd playlists, newest first. Find playlist numbers with List user playlists. No API key required.

**Inputs**

- User (`user`, text, required): The Openwhyd username (as in openwhyd.org/adrien), the user's id, or a link to their profile.
- Playlist number (`playlist_number`, number, required): The playlist's number, as in openwhyd.org/adrien/playlist/10. At least 0.
- Number of tracks (`limit`, number): How many tracks to return, 1 to 200. Defaults to 20. From 1 to 200.
- After track (`after`, text): For the next page: the `next_after` value from the previous run. Leave empty to start with the newest tracks.

**Outputs**

- `count` (number): How many tracks came back.
- `has_more` (true/false): True when there are older tracks to fetch.
- `next_after` (text): Pass this as After track to get the next page; empty on the last page.
- `playlist_number` (number): The playlist asked for.
- `tracks` (list): The playlist's tracks, newest first.
- `user` (text): The user asked for.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_after": "69f061810856594e72edd1de",
  "playlist_number": 10,
  "tracks": [
    {
      "comment": null,
      "embed_id": "/yt/AVUR778jnmE",
      "image_url": "https://i.ytimg.com/vi/AVUR778jnmE/hqdefault.jpg",
      "is_repost": false,
      "likes": 0,
      "platform": "YouTube",
      "playlist_name": "\ud83d\udef8 electronica",
      "playlist_number": 10,
      "plays": 2,
      "posted_at": "2026-04-28T07:28:01Z",
      "posted_by_id": "4d94501d1f78ac091dbc9b4d",
      "posted_by_name": "Adrien Joly",
      "reposted_from_user_name": null,
      "reposts": 0,
      "source_url": "https://www.youtube.com/watch?v=AVUR778jnmE",
      "title": "Owusu & Hannibal - \"Lonnie's Secret\"",
      "track_id": "69f061810856594e72edd1de",
      "url": "https://openwhyd.org/c/69f061810856594e72edd1de"
    }
  ],
  "user": "adrien"
}
```

### List user playlists

List a user's Openwhyd playlists with how many tracks each holds. No API key required.

**Inputs**

- User (`user`, text, required): The Openwhyd username (as in openwhyd.org/adrien), the user's id, or a link to their profile.

**Outputs**

- `count` (number): How many playlists they have.
- `playlists` (list): Their playlists, oldest first.
- `user` (text): The user asked for.

**Example output**

```json
{
  "count": 1,
  "playlists": [
    {
      "image_url": "https://openwhyd.org/img/playlist/4d94501d1f78ac091dbc9b4d_1",
      "name": "\ud83c\udfbc  Classical & epic",
      "owner_id": "4d94501d1f78ac091dbc9b4d",
      "playlist_number": 1,
      "track_count": 52,
      "url": "https://openwhyd.org/u/4d94501d1f78ac091dbc9b4d/playlist/1"
    }
  ],
  "user": "4d94501d1f78ac091dbc9b4d"
}
```

### List user tracks

List the tracks a user has posted on Openwhyd, newest first, with their comments, playlists and where to listen. Page through older ones with After track. No API key required.

**Inputs**

- User (`user`, text, required): The Openwhyd username (as in openwhyd.org/adrien), the user's id, or a link to their profile.
- Number of tracks (`limit`, number): How many tracks to return, 1 to 200. Defaults to 20. From 1 to 200.
- After track (`after`, text): For the next page: the `next_after` value from the previous run. Leave empty to start with the newest tracks.

**Outputs**

- `count` (number): How many tracks came back.
- `has_more` (true/false): True when there are older tracks to fetch.
- `next_after` (text): Pass this as After track to get the next page; empty on the last page.
- `tracks` (list): Their tracks, newest first.
- `user` (text): The user asked for.

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_after": "6acf2987b45ad085d09cf843",
  "tracks": [
    {
      "comment": "Le 27 octobre, on donne un concert de reprises de Radiohead, au Truskel, a Paris !",
      "embed_id": "/yt/2jsPEOiMNaA",
      "image_url": "https://i.ytimg.com/vi/2jsPEOiMNaA/hqdefault.jpg",
      "is_repost": false,
      "likes": 0,
      "platform": "YouTube",
      "playlist_name": null,
      "playlist_number": null,
      "plays": 2,
      "posted_at": "2026-10-14T07:04:39Z",
      "posted_by_id": "4d94501d1f78ac091dbc9b4d",
      "posted_by_name": "Adrien Joly",
      "reposted_from_user_name": null,
      "reposts": 1,
      "source_url": "https://www.youtube.com/watch?v=2jsPEOiMNaA",
      "title": "Radiohead - Thinking About You",
      "track_id": "6acf2987b45ad085d09cf843",
      "url": "https://openwhyd.org/c/6acf2987b45ad085d09cf843"
    }
  ],
  "user": "adrien"
}
```

### Search

Search Openwhyd for tracks, playlists and users matching some words, such as an artist or a genre. No API key required.

**Inputs**

- Search for (`query`, text, required): The words to look for, e.g. an artist or song.

**Outputs**

- `playlist_count` (number): How many playlists matched.
- `playlists` (list): Matching playlists, best match first.
- `query` (text): The words searched for.
- `track_count` (number): How many tracks matched.
- `tracks` (list): Matching tracks, best match first.
- `user_count` (number): How many users matched.
- `users` (list): Matching users, best match first.

**Example output**

```json
{
  "playlist_count": 19,
  "playlists": [
    {
      "image_url": "https://openwhyd.org/img/playlist/51227e637e91c862b2aaf29d_29",
      "name": "Daft Punk",
      "owner_id": "51227e637e91c862b2aaf29d",
      "playlist_number": 29,
      "track_count": 61,
      "url": "https://openwhyd.org/u/51227e637e91c862b2aaf29d/playlist/29"
    }
  ],
  "query": "daft punk",
  "track_count": 20,
  "tracks": [
    {
      "comment": null,
      "embed_id": "/yt/LMNlm7khYwA",
      "image_url": "https://i.ytimg.com/vi/LMNlm7khYwA/hqdefault.jpg",
      "is_repost": false,
      "likes": 0,
      "platform": "YouTube",
      "playlist_name": null,
      "playlist_number": null,
      "plays": 2,
      "posted_at": "2026-10-13T19:55:31Z",
      "posted_by_id": "51ffab157e91c862b2af9030",
      "posted_by_name": "Yvad",
      "reposted_from_user_name": null,
      "reposts": 0,
      "source_url": "https://www.youtube.com/watch?v=LMNlm7khYwA",
      "title": "Daft Punk - Fresh (Official Audio)",
      "track_id": "6ace8cb3b45ad085d09cf838",
      "url": "https://openwhyd.org/c/6ace8cb3b45ad085d09cf838"
    }
  ],
  "user_count": 0,
  "users": []
}
```