# Music Nerd API

> Music Nerd builds source-backed artist profiles: links, research, Lore, and artists' own interview answers. The Music Nerd API serves that data and runs the research behind it.

## Start here

- [Quickstart](https://musicnerd-docs.vercel.app/quickstart): Make a first request.
- [Authentication](https://musicnerd-docs.vercel.app/authentication): Which endpoints are public and which need a Privy access token.
- [Full documentation as one file](https://musicnerd-docs.vercel.app/llms-full.txt): Every page below as Markdown, in navigation order.
- Every page is also available as Markdown: append `.md` to its URL, or request it with `Accept: text/markdown`.

API base URL: https://musicnerd-api.vercel.app

## Documentation

- [Music Nerd API](https://musicnerd-docs.vercel.app/): Artist profiles, research and onboarding, behind Music Nerd and open to other clients.
- [Quickstart](https://musicnerd-docs.vercel.app/quickstart): Make your first request to the Music Nerd API.
- [Authentication](https://musicnerd-docs.vercel.app/authentication): Public endpoints, access tokens, and the scheduler secret.
- [Artist knowledge for agents](https://musicnerd-docs.vercel.app/artist-knowledge): Retrieve original artist evidence, exact history and explicit coverage through one API.

## API reference

- [Check health](https://musicnerd-docs.vercel.app/api-reference/health/get): Check health
- [Advance research](https://musicnerd-docs.vercel.app/api-reference/research/advance): Advance research
- [Run the research scheduler](https://musicnerd-docs.vercel.app/api-reference/research/scheduler): Run the research scheduler
- [Look again](https://musicnerd-docs.vercel.app/api-reference/artists/research-refresh): Look again
- [Request question research](https://musicnerd-docs.vercel.app/api-reference/research/question): Request question-directed research
- [Read question research](https://musicnerd-docs.vercel.app/api-reference/research/question-status): Read question research progress
- [Review queue](https://musicnerd-docs.vercel.app/api-reference/research/discoveries): List discoveries for artist review
- [Review a discovery](https://musicnerd-docs.vercel.app/api-reference/research/review-discovery): Review a research discovery
- [Read research original](https://musicnerd-docs.vercel.app/api-reference/research/research-evidence): Read a public research original
- [Onboarding chat turn](https://musicnerd-docs.vercel.app/api-reference/onboarding/chat): Onboarding chat turn
- [Onboarding state](https://musicnerd-docs.vercel.app/api-reference/onboarding/state): Onboarding state
- [Artist brief](https://musicnerd-docs.vercel.app/api-reference/knowledge/brief): Get artist orientation
- [List artist sources](https://musicnerd-docs.vercel.app/api-reference/knowledge/sources): List accessible sources
- [Search original evidence](https://musicnerd-docs.vercel.app/api-reference/knowledge/search): Find original evidence
- [Read an original source](https://musicnerd-docs.vercel.app/api-reference/knowledge/read-source): Read an original passage
- [Interview history](https://musicnerd-docs.vercel.app/api-reference/knowledge/history): Read answers and corrections
- [Research status](https://musicnerd-docs.vercel.app/api-reference/knowledge/research-status): Read research progress
- [Recover missing source text](https://musicnerd-docs.vercel.app/api-reference/knowledge/extract): Recover missing source text
- [Read mandatory interview memory](https://musicnerd-docs.vercel.app/api-reference/interview/memory): Read mandatory interview memory
- [List active interview boundaries](https://musicnerd-docs.vercel.app/api-reference/interview/list-boundaries): List active interview boundaries
- [Save an explicit interview boundary](https://musicnerd-docs.vercel.app/api-reference/interview/boundary): Save an explicit interview boundary
- [Retract an interview boundary](https://musicnerd-docs.vercel.app/api-reference/interview/retract-boundary): Retract an interview boundary
- [Restore saved interview](https://musicnerd-docs.vercel.app/api-reference/interview/session-state): Restore saved interview
- [Start interview sitting](https://musicnerd-docs.vercel.app/api-reference/interview/start-session): Start interview sitting
- [Save prepared question](https://musicnerd-docs.vercel.app/api-reference/interview/offer-question): Save prepared question
- [Save exact interview answer](https://musicnerd-docs.vercel.app/api-reference/interview/save-answer): Save exact interview answer
- [Finish interview sitting](https://musicnerd-docs.vercel.app/api-reference/interview/finish-session): Finish interview sitting
- [List saved interview responses](https://musicnerd-docs.vercel.app/api-reference/interview-responses/list): List saved interview responses
- [Read an exact response](https://musicnerd-docs.vercel.app/api-reference/interview-responses/read): Read an exact interview response
- [Revise a saved response](https://musicnerd-docs.vercel.app/api-reference/interview-responses/revise): Revise a saved interview response
- [Review response versions](https://musicnerd-docs.vercel.app/api-reference/interview-responses/versions): List response versions