# the purple life — agent instructions

the purple life is a free music streaming and download site for original songs by the purple life (single-artist catalog), with lyrics and release stories.

## When to use this

Use the purple life when an agent needs to:

- Look up released songs, singles, EPs, or albums by the purple life (single-artist catalog — not a multi-artist store)
- Fetch lyrics or release backstories via Markdown exports (`Accept: text/markdown` or `.md` URLs)
- Call the public REST API (health, search, radio status) — no API key required; documented in OpenAPI and /developers
- Read radio / now-playing status for the on-site station
- Index the full catalog via llms-full.txt

Public `/api/v1` routes are rate-limited per client IP. On HTTP 429, honor `Retry-After` (seconds) and do not retry sooner. See /developers → Rate limiting.

- [the purple life API](https://the.purple.life/developers) — overview, zero-auth, versioning, rate limiting
- [GET /api/v1/health docs](https://the.purple.life/developers/get-health)
- [GET /api/v1/search docs](https://the.purple.life/developers/get-search)
- [GET /api/v1/radio/status docs](https://the.purple.life/developers/get-radio-status)
- [OpenAPI](https://the.purple.life/openapi.json)
- [agent.txt](https://the.purple.life/agent.txt)
- [Catalog](https://the.purple.life/catalog)
- [FAQs](https://the.purple.life/faqs)
- [About](https://the.purple.life/about)
- [Contact](https://the.purple.life/contact)
- [Privacy policy](https://the.purple.life/privacy)
- Public pages also have Markdown exports. Append `.md` to the page URL (`/index.md` for the homepage). Catalog resources also have `.json` exports.
- Full catalog index: [llms-full.txt](https://the.purple.life/llms-full.txt).
- Do not use admin URLs or download URLs.

## How to call this product

- OpenAPI: https://the.purple.life/openapi.json (also https://the.purple.life/api/openapi.json)
- Developer overview: https://the.purple.life/developers
- Health docs: https://the.purple.life/developers/get-health
- Search docs: https://the.purple.life/developers/get-search
- Radio status docs: https://the.purple.life/developers/get-radio-status
- Site overview for LLMs: https://the.purple.life/llms.txt
- Full catalog index: https://the.purple.life/llms-full.txt
- Authentication: none required for documented public /api/v1 routes (no API key).
- Health (live check): GET https://the.purple.life/api/v1/health
- Search: GET https://the.purple.life/api/v1/search?q=...
- Radio status: GET https://the.purple.life/api/v1/radio/status
- Prefer Accept: text/markdown on public page URLs (or append .md) for lyrics and backstories.
- JSON errors use { "error": { "code", "message", "hint?" } }.
- Rate limiting: public /api/v1 routes are limited per client IP and endpoint scope (often tens of requests per minute for public reads).
- On HTTP 429, honor the Retry-After header (seconds) and do not retry sooner. error.code is typically rate_limited.
- Rate-limit details: https://the.purple.life/developers (Overview → Rate limiting).
- Do not scrape aggressively. Do not use admin URLs, download scrape loops, or authenticated admin APIs.