# SoundCloud (/docs/soundcloud) Read one public SoundCloud track with its plays, likes, comments, reposts and genre through one unified API SoundCloud hosts music and audio from independent artists and labels. This endpoint reads one public track by its link and returns it in the canonical `Post` shape, with the track's reach on SoundCloud in `post.engagement`. Base URL: `/v1/soundcloud/...` ## Quickstart ### Read a track Pass the track's link as `url`. It has two parts after the host: the artist, then the track. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/soundcloud/track?url=https%3A%2F%2Fsoundcloud.com%2Fkehlanimusic%2Flights-on-feat-big-sean" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "post": { "id": "2306956232", "url": "https://soundcloud.com/kehlanimusic/lights-on-feat-big-sean", "content": { "text": "Lights On (feat. Big Sean)", "duration_seconds": 30 }, "author": { "username": "kehlanimusic", "display_name": "Kehlani" }, "engagement": { "views": 99159, "likes": 3613, "comments": 25, "shares": 36, "saves": null }, "published_at": "2026-04-22T00:39:25.000Z", "ext": { "genre": "R&B" } } } } ``` ## Questions people ask ### Where are the plays and reposts? Plays are `post.engagement.views` and reposts are `post.engagement.shares`. Likes and comments keep their own names. ### Why is the length only 30 seconds? `post.content.duration_seconds` is the playable length. A track that streams only a preview on SoundCloud reports the preview's length. ### Can I read a playlist? Not here. A playlist (a `/sets/` link) is not a track and answers `400` before any charge. ## All endpoints ## Platform notes **A track that cannot be read answers `503` and is refunded.** SoundCloud gives the same answer for a track that does not exist and for one that could not be read at that moment, so it is never reported as a not-found. ## Next steps - [Spotify](/docs/spotify.md): Artists, tracks, albums, playlists and podcasts. - [Post schema](/docs/schema/post.md): Every field of the canonical Post shape.