API reference
The Music Nerd API
Artist profiles, research and onboarding. Find the endpoint you need and try it from the page.
Health
Research
GETRead stored artist Latest
/api/artist/{id}/latestGETRead the Update Latest request/api/artist/{id}/latest-refreshPOSTRequest an Update Latest check/api/artist/{id}/latest-refreshPOSTAdvance research/api/research/advanceGETRun the research scheduler/api/research/advancePOSTLook again/api/artist/{id}/research/refreshPOSTRequest question research/api/artist/{id}/research/questionsGETRead question research/api/artist/{id}/research/questions/{jobId}POSTContinue question research/api/artist/{id}/research/questions/{jobId}/continueGETReview queue/api/artist/{id}/research/discoveriesPOSTReview a discovery/api/artist/{id}/research/discoveries/{candidateId}/reviewGETRead research original/api/artist/{id}/research/evidence/{evidenceId}Artist chat
Onboarding
Artist knowledge
GETArtist brief
/api/artist/{id}/knowledge/briefGETList artist sources/api/artist/{id}/knowledge/sourcesGETSearch original evidence/api/artist/{id}/knowledge/searchGETRead an original source/api/artist/{id}/knowledge/sources/{sourceId}GETInterview history/api/artist/{id}/knowledge/historyGETResearch status/api/artist/{id}/research/statusPOSTRecover missing source text/api/artist/{id}/knowledge/sources/extractInterview memory and sessions
GETRead mandatory interview memory
/api/artist/{id}/interview/memoryGETList active interview boundaries/api/artist/{id}/interview/boundariesPOSTSave an explicit interview boundary/api/artist/{id}/interview/boundariesPOSTRetract an interview boundary/api/artist/{id}/interview/boundaries/{boundaryId}/retractGETRestore saved interview/api/artist/{id}/interview/sessionPOSTStart interview sitting/api/artist/{id}/interview/sessionGETRead question preparation/api/artist/{artistId}/interview/session/{sessionId}/preparePOSTPrepare or offer the next question/api/artist/{artistId}/interview/session/{sessionId}/preparePOSTSave prepared question/api/artist/{id}/interview/session/{sessionId}/offerPOSTSave exact interview answer/api/artist/{id}/interview/answers/{answerId}POSTFinish interview sitting/api/artist/{id}/interview/session/{sessionId}/finishGETRestore the interview/api/artist/{id}/interviewPOSTRun an interview action/api/artist/{id}/interviewInterview response review
Artist lookups
POSTFind an artist by Spotify ID
/api/findArtistBySpotifyIDPOSTFind an artist by Instagram handle/api/findArtistByIGPOSTFind an artist's X handle/api/findTwitterHandlePOSTSearch artists/api/searchArtistsGETFind a track on other services/api/trackLinksGETRead the contributor leaderboard/api/leaderboardGETRedirect to an artist's image/api/artist/{id}/imageAgent reports
MCP server
Users and profile
GETRead your account
/api/user/{id}PATCHSet your user name/api/user/{id}POSTRecord the user-name prompt/api/user/{id}/name-promptGETYour approved claim/api/user/has-claimGETYour profile photo/api/user/profile-imagePOSTUpload your profile photo/api/user/profile-imageGETYour artists/api/profile/artistsGETYour contribution summary/api/profile/summaryGETUpdates from your artists/api/profile/updatesAccount
Artist bio
GETRead the About
/api/artistBio/{id}PUTSave or regenerate the About/api/artistBio/{id}POSTReport a problem with the About/api/artist/{id}/bio-correctionsPOSTSuggest a Lore source/api/artist/{id}/lore-suggestionsGETDirectory discovery status/api/artist/{id}/directory-discoveryGETExport the Lore document/api/artist/{id}/knowledge-doc/exportActivity and contributions
Artist links
PUTSave the artist's link order
/api/artist/link-orderPOSTSet or clear an artist link/api/directEditLinkPOSTRemove an artist link/api/removeArtistDataPOSTCheck a profile link is live/api/validateLinkGETList platform URL patterns/api/platformRegexesGETList link suggestions/api/artist/{id}/link-suggestionsPOSTReview a link suggestion/api/artist/{id}/link-suggestionsAdmin
GETAgent work
/api/admin/agent-workGETArtist data/api/admin/artist-dataPATCHReview an About correction report/api/admin/bio-corrections/{id}GETRead the About for a report/api/admin/bio-corrections/{id}/aboutPUTSave the About for a report/api/admin/bio-corrections/{id}/aboutGETList MCP keys/api/admin/mcp-keysPOSTCreate an MCP key/api/admin/mcp-keysPOSTRevoke an MCP key/api/admin/mcp-keys/{id}/revokeGETPending UGC count/api/pendingUGCCount