SoundCloud

Search tracks, fetch metadata, and extract full audio download URLs (progressive MP3 / HLS) for public SoundCloud tracks.

4 endpoints68 calls3/3 passing
Get API key

Search the catalog by text query.

GET/v1/…soundcloud/search
passing · 1.9s5m cache

Try it

Checking your keys…

Parameters

q

string · query · required

Search query.

limit

number · query · optional

Items per page (1-50). Default 20.

page

number · query · optional

Page 1-based. Default 1.

Example response

{"project":"music:soundcloud",  "data": {"page":1,"count":20,    "items": [      {"url":"https://soundcloud.com/user-167787390/the-weeknd-blinding-lights","image":"https://i1.sndcdn.com/artworks-12n314eZNB8i9ydb-S3uaYg-t500x500.jpg","title":"The Weeknd - Blinding Lights full",        "artist": {"id":978685288,"url":"https://soundcloud.com/user-167787390","name":"Minh Prime"        },"trackId":1316258221,"likeCount":43746,"playCount":2715988,"durationMs":762820,"isExplicit":false,"releaseDate":"2022-08-02T06:27:33Z"      },      {"url":"https://soundcloud.com/theweeknd/blinding-lights","genre":"R & B","image":"https://i1.sndcdn.com/artworks-QSijq2r1DiZI-0-t500x500.jpg","title":"Blinding Lights",        "artist": {"id":3274725,"url":"https://soundcloud.com/theweeknd","name":"The Weeknd"        },"trackId":718846078,"likeCount":528112,"playCount":32580337,"durationMs":30000,"isExplicit":false,"releaseDate":"2019-11-29T00:00:00Z"      },      {"url":"https://soundcloud.com/jump-singers/blinding-lights","genre":"Jazz & Blues","image":"https://i1.sndcdn.com/artworks-LOzwVN5TpQHegdjC-JZ0HFg-t500x500.jpg","title":"Blinding Lights",        "artist": {"id":1176114340,"url":"https://soundcloud.com/jump-singers","name":"Jump Singers"        },"trackId":2274096695,"likeCount":1070,"playCount":48906,"durationMs":208769,"isExplicit":false,"releaseDate":"2026-03-04T12:16:33Z"      }    ],"total":10462,"hasMore":true,"nextPage":2  },"timestamp":"2026-06-07T13:48:39Z"}

Errors

  • 401Missing or invalid x-api-key
  • 404Not found or private
  • 429Rate limit or monthly quota reached

Code

const data = await client.run(  "music:soundcloud",  "search",  { q: "blinding lights" });