Partner Metadata API

Overview

Pull album covers and asset metadata as an approved reporting partner.

Machine-to-machine endpoints for approved reporting partners to pull asset metadata from Record.

Two endpoints ship today: a single lookup and a batch lookup. Roadmap shows where this surface grows.

Base URL: https://ingest.takerecord.com

Authentication#

Every request carries a Bearer token:

code

Authorization: Bearer trk_live_<key>

The key uses the same system as the Catalogue Ingest API. We issue it to an approved reporting partner and scope it to covers:read.

It is not tied to one client. A reporting partner may serve several catalogue clients, so a scope gates access, not a tenant binding. You can revoke, rotate and expire it on its own, and we track its use per key.

Send no x-client-id. Album covers are shared reference data, and they are not tenant-scoped. Per-client endpoints on the roadmap will accept an x-client-id authorised against the catalogue clients a partner acts for.

Rate limit: 600 requests per minute per key for a single lookup. A 429 response carries a Retry-After header in seconds. Wait that long, then retry.

To preload a whole catalogue, use the batch lookup rather than one request per asset.

Errors are always { "error": "<human readable>", "code": "<MACHINE_CODE>" } plus an x-request-id header. Quote that id when you report an issue.