crate.artist(key)

artist(key: string, opts?: RequestOptions): Promise<ArtistDossierContract>

Fetch an artist dossier in one call — the shortcut when you already mean a specific artist. Hand it almost anything (a name, slug, 64-hex cluster_id, or discogs:/mbid: locator): a direct key hits /artist/{key}, while a locator or bare numeric id is resolved first. The dossier is full by default; pass { fields } to trim it. An unresolved locator throws CrateNotFoundError — use artistOrNull to receive null. In v2 (cluster-first), release/master detail attaches here as the discography dimension and Bandcamp standing as bandcamp_emergence / bandcamp_tastemaker — there are no standalone master/bandcamp methods.

Endpoint	GET /api/v2/artist/{key}
Auth	key
Returns	ArtistDossierContract
Retryable	yes
Idempotent	yes

Example

const a = await crate.artist('Four Tet');                 // name → dossier
await crate.artist('discogs:1234');                       // locator → resolve → dossier
await crate.artist('Four Tet', { fields: ['discography'] }); // trim to one facet

Throws

• not_found — when a locator/numeric id resolves to no cluster.
• invalid_fields — ).