index.html.md

title	Audius API Docs
toc_footers	<a href='https://audius.co'>Audius App</a> <a href='https://github.com/AudiusProject'>github.com/AudiusProject</a> <a href='https://audius.org'>audius.org</a>
search	true
language_tabs	shell Shell http HTTP javascript JavaScript python Python php PHP java Java ruby Ruby go Go
includes	docs embed

<script type="text/javascript"> (function() { const set = async () => { const sample = (arr) => arr[Math.floor(Math.random() * arr.length)] let host = sample((await (await fetch('https://api.audius.co')).json()).data) if (host.endsWith('/')) { host = host.slice(0, -1) } function walkText(node) { if (node.nodeType == 3) { node.data = node.data.replace(/AUDIUS_API_HOST/g, host) } if (node.nodeType == 1 && node.nodeName != "SCRIPT") { for (var i = 0; i < node.childNodes.length; i++) { walkText(node.childNodes[i]); } } } walkText(document.body); } set() })() </script>

Audius API Docs

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

Selecting a Host

Code Sample

curl https://api.audius.co

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

const sample = (arr) => arr[Math.floor(Math.random() * arr.length)]
const host = await fetch('https://api.audius.co')
  .then(r => r.json())
  .then(j => j.data)
  .then(d => sample(d))

import random
import requests

host = random.choice((requests.get('https://api.audius.co')).json()['data'])

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

https://api.audius.co

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.

For the following documention, we've selected one for you:

AUDIUS_API_HOST

Specifying App Name

If you're integrating the Audius API into an app in production, we ask that you include an &app_name=<YOUR-UNIQUE-APP-NAME> param with each query. Your unique app name is entirely up to you!