crate.artists(params)
artists(params?: ArtistBrowseParams, opts?: RequestOptions): Promise<ArtistBrowseResponse>Browse the artist grain — the discovery grid. Filter by genre + style (exact, case-sensitive — see facets for the live vocabulary; an unknown value returns an empty items with a note, never throws) and tier (breakout|rising|steady). Sorted by discovery (rising artists first) unless you pass sort: 'reach'. Each row carries cluster_id — feed a non-null one to artist. Offset pagination is capped at offset + limit ≤ 500 (narrow with filters, don’t page deep); a _links.next appears while more fits in-window.
| Endpoint | GET /api/v2/artists |
| Auth | key |
| Returns | ArtistBrowseResponse |
| Retryable | yes |
| Idempotent | yes |
Example
Section titled “Example”const grid = await crate.artists({ genre: 'Electronic', tier: 'rising' });grid.items.forEach((a) => console.log(a.display, a.emergence_tier, a.cluster_id));Throws
Section titled “Throws”CrateAPIError— on a non-2xx response.