curl --fail-with-body -X GET "$RAWCHUNKS_API/api/songs"
{
"items": [
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
}
]
}Songs and takes
List songs
List the public catalog or one creator’s library.
GET
/
api
/
songs
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/songs"
{
"items": [
{
"id": "<string>",
"title": "<string>",
"creator": "<string>",
"url": "<string>",
"created_at": "<string>",
"family": {},
"basis": {},
"source": {},
"metadata_cid": {},
"image": {},
"album_id": {},
"network": {},
"chain_song_id": {},
"tx_hash": {},
"version": 123,
"licenses": 123,
"stream_price": 123,
"license_price": 123,
"duration": {},
"tags": [
"<string>"
],
"public": true
}
]
}Without
creator, only public songs are returned, newest first. A creator query includes that owner’s private songs and requires their account header. No default page cap is applied; send limit and offset. There is no total-count or cursor field.
Paginate and manage a library.
Headers and parameters
string
Owner library. Requires x-session-user-address with the same address.
integer
Positive integer page size. Minimum:
1.integer
Nonnegative integer offset. Minimum:
0.Response (200)
Success.object[]
Show Properties
Show Properties
string
required
string
required
string
required
string
required
string
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
string | null
integer
integer
number
Listed USDC per minute.
number
Listed USDC per license.
number | null
Seconds.
string[]
boolean
Catalog visibility. Media URLs are not private storage.
Errors
Failed JSON responses contain anerror string. Check the HTTP status before reading a successful result. See job handling for interrupted or uncertain submissions.
| Status | Meaning |
|---|---|
400 | Invalid request. |
500 | Request failed. |
curl --fail-with-body -X GET "$RAWCHUNKS_API/api/songs"
⌘I