music nerd

Users and profileUpdates from your artists

Users and profile

Updates from your artists

The latest cards from the caller's artists, six artists per page in the same order as Your artists, up to two per artist, newest first. Built from the stored artist Latest: releases, Instagram posts, In Process moments and published interview answers, with a missing or failed snapshot reported in unavailableProviders. checked is how many artists have been read so far; next is the offset for the next six.

GET/api/profile/updates
GET/api/profile/updates

The latest cards from the caller's artists, six artists per page in the same order as Your artists, up to two per artist, newest first. Built from the stored artist Latest: releases, Instagram posts, In Process moments and published interview answers, with a missing or failed snapshot reported in unavailableProviders. checked is how many artists have been read so far; next is the offset for the next six.

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

The artist to start from, in the caller's artist order. Up to six digits; defaults to 0.

kindstring

Which cards to keep. All, Release, Socials (Instagram posts and In Process moments) or Lore (interview answers); Instagram, Interview and In-Process are older filter names that still work.

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/updates?offset=0&kind=All' \
  --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

The artist to start from, in the caller's artist order. Up to six digits; defaults to 0.

Default: "0"

kindstring · enum

Which cards to keep. All, Release, Socials (Instagram posts and In Process moments) or Lore (interview answers); Instagram, Interview and In-Process are older filter names that still work.

Values: "All", "Release", "Socials", "Lore", "Instagram", "Interview", "In-Process"

Default: "All"

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 cards. Cache-Control: private, no-store.

statusstring · enumrequired

Values: "ok"

userIdstringrequired

format: uuid

itemsarray<ProfileUpdate>required
Item properties for items
idstringrequired
kindstring · enumrequired

Values: "release", "instagram", "interview", "moment"

titlestringrequired
textstringrequired
datestringrequired
imageUrlstring | nullrequired
imageDimensionsobject
Properties for imageDimensions
widthnumber
heightnumber
imageCaptionstringrequired
sourceUrlstring | nullrequired
sourceLabelstringrequired
momentKindstring · enum

Values: "video", "audio", "image", "writing", "other"

listeningLinksarray<object>
Item properties for listeningLinks
siteNamestring
labelstring
hrefstring
iconSrcstring
artistIdstringrequired

format: uuid

artistNamestringrequired
checkedintegerrequired

How many of the caller's artists have been read, this page included.

nextinteger | nullrequired

The offset for the next page, or null once every artist has been read.

unavailablebooleanrequired

True when at least one artist's Latest could not be fully read.

unavailableProvidersarray | nullrequired

Which providers were failed or missing, sorted; null when a read failed for an unknown reason.

Properties for unavailableProviders

string · enum · "spotify", "deezer", "inprocess"