# 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
- Published archive audit manifest (JSON): https://music.jamesbpollack.com/catalog-manifest.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.
- Catalog metadata includes Ableton-derived BPM, project/source collection, arrangement complexity, plugin highlights, instrumentation tags, and detected vocal-sample sources where available.
- `mood` filter values: Atmospheric, Dreamy, Hypnotic, Driving, Intense, Dark, Bright, Uplifting, Melancholic.
- Canonical track pages follow `/en/track/<year>/<title-slug>` and are listed in `/sitemap.xml`.
- Raw archive paths remain stable track identifiers for APIs, licensing, analytics, and player handoff, but public song-page links should use `canonical_url` from `/track-feed.json` or `/api/agent-search`.
- Player URLs may still use `/en?track=<encoded track path>` for direct playback handoff.
- 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, Ableton production fields, vocal-sample flags, etc.). Add `?limit=&offset=` to page through results (returns `{ total, limit, offset, count, tracks }`); omit both for the full array.
- `GET /track-feed.json` returns a compact indexing feed with canonical song-page URLs, legacy alias URLs, mood tags, and production metadata.
- `GET /catalog-manifest.json` returns the published-track filename, ID3, calendar, technical decode, starter-bundle, and quality-review manifest; hidden tracks are omitted.
- `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`, `/catalog-manifest.json`, and sitemap output.