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
Try it Endpoint GET Check health Read stored artist Latest Read the Update Latest request Request an Update Latest check Advance research Run the research scheduler Look again Request question research Read question research Continue question research Review queue Review a discovery Read research original Chat about an artist Start the claim build Onboarding state Reset the claim build Onboarding chat turn Artist brief List artist sources Search original evidence Read an original source Interview history Research status Recover missing source text Read mandatory interview memory List active interview boundaries Save an explicit interview boundary Retract an interview boundary Restore saved interview Start interview sitting Read question preparation Prepare or offer the next question Save prepared question Save exact interview answer Finish interview sitting Restore the interview Run an interview action List saved interview responses Read an exact response Revise a saved response Review response versions Find an artist by Spotify ID Find an artist by Instagram handle Find an artist's X handle Search artists Find a track on other services Read the contributor leaderboard Redirect to an artist's image Send an MCP message MCP resource metadata Authorization server metadata Register a client Start authorization Get a token Read a connection request Approve or deny an agent List connected agents Disconnect an agent Check a team member Read the signed-in account Read your account Set your user name Record the user-name prompt Your approved claim Your profile photo Upload your profile photo Your artists Your contribution summary Updates from your artists Claim an artist profile Approve a claim Reject a claim Revoke a claim Link a wallet Read the About Save or regenerate the About Report a problem with the About Suggest a Lore source Directory discovery status Export the Lore document Activity feed Recently edited artists Profile edit history Submission count Submitted links Save the artist's link order Set or clear an artist link Remove an artist link Check a profile link is live List platform URL patterns List link suggestions Review a link suggestion Artist data Review an About correction report Read the About for a report Save the About for a report Pending UGC count Photo choices Choose a provider photo Upload a profile image Set the header position Sign an upload Complete an upload Upload a file directly GET / api/ profile/ updates
Send 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 Query Headers 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.
curl --request GET \
--url 'https://musicnerd-api.vercel.app/api/profile/updates' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--header 'X-Profile-Account: 6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6'
{
"status" : "ok" ,
"userId" : "6f1d2e3a-4b5c-4d6e-8f90-a1b2c3d4e5f6" ,
"items" : [
{
"id" : "aab92f80-f9e1-4299-aa33-7dd85c8de5d3:release:spotify:4uLU6hMCjMI75M1A2tKUQC" ,
"kind" : "release" ,
"title" : "Mambo Mania" ,
"text" : "album" ,
"date" : "2026-09-12" ,
"imageUrl" : "https://i.scdn.co/image/example" ,
"imageCaption" : "Mambo Mania artwork" ,
"sourceUrl" : "https://open.spotify.com/album/4uLU6hMCjMI75M1A2tKUQC" ,
"sourceLabel" : "Listen on Spotify" ,
"artistId" : "aab92f80-f9e1-4299-aa33-7dd85c8de5d3" ,
"artistName" : "Bio Ritmo"
}
],
"checked" : 1 ,
"next" : null ,
"unavailable" : false ,
"unavailableProviders" : []
}
Authorizations Authorizationstring header required
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"
Response Status 200 400 401 409 503 application/json A page of cards. Cache-Control: private, no-store.
statusstring · enum required
Values: "ok"
userIdstring required
format: uuid
itemsarray<ProfileUpdate> required
Item properties for items kindstring · enum required
Values: "release", "instagram", "interview", "moment"
imageUrlstring | null required
imageDimensionsobject
Properties for imageDimensions imageCaptionstring required
sourceUrlstring | null required
sourceLabelstring required
momentKindstring · enum
Values: "video", "audio", "image", "writing", "other"
listeningLinksarray<object>
Item properties for listeningLinks artistIdstring required
format: uuid
checkedinteger required
How many of the caller's artists have been read, this page included.
nextinteger | null required
The offset for the next page, or null once every artist has been read.
unavailableboolean required
True when at least one artist's Latest could not be fully read.
unavailableProvidersarray | null required
Which providers were failed or missing, sorted; null when a read failed for an unknown reason.
Properties for unavailableProviders string · enum · "spotify", "deezer", "inprocess"