Conventions

Canonical identifiers

Library resources are addressed by canonical id, not by any source's identifier. A Plex rating key or a MusicBrainz ID will not work as a path parameter; there are lookup routes for translating.

See Canonical records.

Timestamps

UTC, ISO 8601.

Note that added_at_plex is Plex's timestamp, not an insert time here. It does not change on re-import.

Windows

Feed and chart endpoints take a time window. Discoveries are computed as the first play per canonical falling inside it, which is why the same window can return a very different set from trending.

Errors

{ "detail": "…" }

422 with a detail array for validation failures.

Rate limits

Media does not rate-limit you. Its upstream sources rate-limit it, which is why enrichment is scheduled and explicit rather than happening on read.