Skip to main content

REST API Quick Start

info

While this documentation is being completed, checkout the original API reference at https://audiusproject.github.io/api-docs

The Audius API is entirely free to use. We ask that you adhere to the guidelines in this documentation and always credit artists.

The Audius REST API lets you query, stream, and search for tracks, users and playlists across the network.

Explore and Build with Postman

Check out the Postman collection here to get started with the Audius API or use the button below to open the collection in the Postman App.

Run In Postman

Selecting a Host​

Audius is a decentralized music streaming service. To use the API, you first select an API endpoint from the list of endpoints returned by:

Request​

GET https://api.audius.co HTTP/1.1

Response​

{
  "data": [
    "https://audius-discovery-1.cultur3stake.com",
    "https://audius-discovery-1.theblueprint.xyz"
    "https://audius-discovery-11.cultur3stake.com",
    "https://audius-discovery-12.cultur3stake.com",
    "https://audius-discovery-13.cultur3stake.com",
    ...
    "https://dn1.monophonic.digital",
    "https://dn1.nodeoperator.io",
    "https://dn1.stuffisup.com",
  ]
}

Once you've selected a host, all API requests can be sent directly to it. We recommend selecting a host each time your application starts up as availability may change over time.

Specifying App Name​

If you're integrating the Audius API into an app in production, we ask that you include the app_name param with each query. Your unique app name is entirely up to you!

&app_name=<YOUR-UNIQUE-APP-NAME>