music nerd

Users and profileYour artists

Users and profile

Your artists

The artists the caller has contributed to (added, had a link accepted on, or edited as the claimant), 24 per page in name order, with an optional name search. imageUrl is the stored portrait when it is a local path or a credential-free HTTPS URL, else null.

GET/api/profile/artists
GET/api/profile/artists

The artists the caller has contributed to (added, had a link accepted on, or edited as the claimant), 24 per page in name order, with an optional name search. imageUrl is the stored portrait when it is a local path or a credential-free HTTPS URL, else null.

Authorization

Authorizationstringrequired

The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Every route here answers about that user only. Kept in this tab only.

Query

offsetstring

Where the page starts. Up to six digits; defaults to 0.

qstring

A case-insensitive name search, up to 200 characters.

Headers

X-Profile-Accountstringrequired

The user id the page believes is signed in. Must equal the token's user, or the response is 409 so the page can refresh instead of showing another account's data.

cURL
curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/profile/artists?offset=0&q=ritmo' \
  --header 'X-Profile-Account: 6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. The signed-in user's access token. Copy it at https://musicnerd.net/access after signing in. Every route here answers about that user only.

Query Parameters

offsetstring

Where the page starts. Up to six digits; defaults to 0.

Default: "0"

qstring

A case-insensitive name search, up to 200 characters.

Header Parameters

X-Profile-Accountstringrequired

The user id the page believes is signed in. Must equal the token's user, or the response is 409 so the page can refresh instead of showing another account's data.

Response

application/json

A page of artists. Cache-Control: private, no-store.

statusstring · enumrequired

Values: "ok"

userIdstringrequired

format: uuid

artistsarray<ProfileArtist>required
Item properties for artists
artistIdstringrequired

format: uuid

artistNamestringrequired

The artist's name, or Unknown artist.

imageUrlstring | nullrequired

A local path or credential-free HTTPS URL, or null.

totalintegerrequired

How many artists match.

nextinteger | nullrequired

The offset for the next page, or null on the last page.