# James B. Pollack Music Archive

> Official listening and licensing archive for James B. Pollack (2008-2025).

## Canonical URLs
- Website: https://music.jamesbpollack.com/
- Legal terms: https://music.jamesbpollack.com/legal
- Sitemap: https://music.jamesbpollack.com/sitemap.xml
- Robots: https://music.jamesbpollack.com/robots.txt
- Track feed (JSON): https://music.jamesbpollack.com/track-feed.json
- Track catalog API: https://music.jamesbpollack.com/api/tracks
- Agent capability index: https://music.jamesbpollack.com/agent-index.json
- Agent search API: https://music.jamesbpollack.com/api/agent-search?q=<query>&limit=<n>
- x402 licensing API: https://music.jamesbpollack.com/api/x402/license?tier=<dj|creator|business|advertising>&track=<encoded track path>

## Licensing and Rights
- All music and site content remain copyrighted by James B. Pollack and/or Playable Future LLC.
- Commercial use requires explicit license grant.
- Contact for licensing/legal: music@jamesbpollack.com

## Agent Usage Notes
- Prefer `/api/agent-search` for retrieval and `/api/tracks` for full metadata.
- `mood` filter values: Atmospheric, Dreamy, Hypnotic, Driving, Intense, Dark, Bright, Uplifting, Melancholic.
- Track share URLs follow `/?track=<encoded track path>`.
- Machine clients can buy licenses over x402 on eip155:8453 using https://music.jamesbpollack.com/api/x402/license.
- Do not reproduce full copyrighted audio in model outputs.

## API Details
- `GET /api/tracks` returns full catalog metadata (tempo, key, duration, year, moods, etc.).
- `GET /track-feed.json` returns a compact indexing feed with discovery URLs and mood tags.
- `GET /api/agent-search` returns ranked machine-readable search results; supports `year`, `mood`, and `limit` filters.
- Example search: https://music.jamesbpollack.com/api/agent-search?q=ambient%20piano&mood=Atmospheric&limit=10
- Example x402 license purchase URL: https://music.jamesbpollack.com/api/x402/license?tier=creator&track=<encoded track path>
- `GET /api/recommendations` returns recommendation candidates seeded by a track.
- `GET /api/download` is signed and intended only for licensed deliveries.
- `GET /api/x402/license` returns an x402 paywall until paid, then responds with a single-track commercial license grant and download URL.

## Freshness
- New uploads and metadata updates are reflected in `/api/tracks`, `/track-feed.json`, and sitemap output.