API Reference
Extract Discogs releases, masters, artists, and labels — search, detail, and discographies — as structured JSON from the public Discogs music database. 7 endpoints documented below.
curl "https://api.crawlora.net/api/v1/discogs/search?q=Daft+Punk+Discovery&type=release" \
-H "x-api-key: $CRAWLORA_API_KEY"Discogs is the reference database for physical and digital music releases. Crawlora's Discogs endpoints return search, release/master detail, and artist/label discographies as normalized JSON — no Discogs API token, rate-limit juggling, or proxy setup.
A search across releases/masters/artists/labels, a release or master by id, or an artist/label with its releases.
Pass a query or a Discogs id to Crawlora's Discogs endpoint (e.g. /discogs/search, /discogs/release, /discogs/artist/{id}/releases).
Receive title, country, formats, labels, genres, styles, catalog numbers, and barcodes as clean JSON, with fields varying by release / master / artist / label.
Batch across search pages and discographies to build catalogs for music research, cataloging, or enrichment.
/discogs/artist/{id}apiKey1 credit/requestReturns a Discogs artist profile: real name, bio, links, name variations, aliases, and group memberships.
Required: id.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: name: “Rick Astley”; uri: discogs.com; profile: 639 characters; urls: 7 entries; name_variations: 23 entries; aliases: 1 entry; groups: 3 entries; images: 12 entries.
/discogs/artist/{id}/releasesapiKey1 credit/requestReturns the releases and masters credited to a Discogs artist, identified by the required `id`. Paged with `page` (default 1) and `per_page` (default 50, max 100). Each entry has its `id`, `type` (`release` or `master`), title, artist, role, format, label, year, thumbnail, and want and collection counts, alongside the total item count and page count.
Required: id. Optional: page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, type, title, artist, role, year, in_wantlist, in_collection. Not in every item: format (7), label (7), main_release_id (13). In the sample: type: master (13), release (7); year: 1,987 to 1,989, median 1,987; title: “I Surrender (To The Spirit Of The Night) / Never Gonna Give…” and 18 other values; artist: Rick Astley (13), Samantha Fox / Rick Astley (1), Eurythmics / Rick Astley (1) and 5 more; format: “7", Jukebox” and 5 other values; label: “Jive, RCA” and 4 other values; in_wantlist: 2 to 520, median 51; in_collection: 2 to 3,258, median 461.
/discogs/label/{id}apiKey1 credit/requestReturns the profile of a Discogs label by its required label `id`: name, profile text, contact info, website URLs, images, data quality rating, and Discogs page URI. The parent label and the list of sub-labels are included, and the parent label appears only when the label has one.
Required: id.
Sampled 14 Oct 2026: 183 items. Filled in every item: id, name. In the sample: name: “100% Elvis” and 182 other values.
/discogs/label/{id}/releasesapiKey1 credit/requestLists the releases on a Discogs label, identified by the required label `id`. Paged with `page` (default 1) and `per_page` (default 50, max 100). Each entry has its release `id`, title, artist, format, catalogue number (`catno`), status, year and thumbnail, and the response reports the total item count across all pages.
Required: id. Optional: page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, title, artist, format, catno, status, year, thumb. In the sample: year: 1,978 to 2,001, median 1,990; title: “Rollercoaster” and 15 other values; thumb: i.discogs.com; artist: “Grid*” and 12 other values; format: “CD, Single, Car” and 10 other values; catno: “74321230772” and 15 other values.
/discogs/master/{id}apiKey2 credits/requestReturns a Discogs master release: the version-agnostic grouping of a release across pressings/reissues (artists, tracklist, genres/styles, videos, images, marketplace stats).
Required: id.
Sampled 14 Oct 2026: 28 items. Filled in every item: uri, title, description. Not in every item: duration (26). In the sample: duration: 105 to 407, median 228; title: “One More Time” and 27 other values; uri: youtube.com; description: median 255 characters.
/discogs/release/{id}apiKey2 credits/requestReturns a Discogs release: artists, labels, formats, tracklist, credits, identifiers, videos, images, and community want/have/rating.
Required: id.
Sampled 14 Oct 2026: 17 items. Filled in every item: uri, title. Not in every item: description (14), duration (16). In the sample: duration: 213 to 560, median 387; title: “Rick Astley - Never Gonna Give You Up (Official Video) (4K…” and 16 other values; uri: youtube.com; description: median 255 characters.
/discogs/searchapiKey1 credit/requestSearches the Discogs database for releases, masters, artists and labels, optionally filtered to one `type`, with `page` and `per_page` (max 100). Release and master results carry country, year, formats, labels, genres, styles, catalog number and barcodes; artist and label results carry id, title and thumbnail.
Required: q. Optional: type (4 allowed values: release, master, artist, label), page, per_page.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, type, title, country, genres, styles, formats, labels and 4 more. Not in every item: year (17). In the sample: title: Daft Punk - Discovery (19), Daft Punk = ダフト・パンク* - Discover… (1); year: 2,001 to 2,024, median 2,014; catno: “V2940” and 10 other values; uri: discogs.com; genres: median 1 entry; country: Europe (8), US (5), Canada (2) and 5 more; styles: median 3 entries; formats: median 4 entries.
Results from the 7 days to 14 Oct 2026. Current status
| Endpoint | Request | Checks passed | Median response |
|---|---|---|---|
| Get a Discogs artist profile | GET /discogs/artist/72872 | 100% | 0.37 s |
| List a Discogs artist's releases | GET /discogs/artist/72872/releases | 100% | 0.66 s |
| Get a Discogs label profile | GET /discogs/label/895 | 100% | 0.74 s |
| List a Discogs label's releases | GET /discogs/label/895/releases | 100% | 1.22 s |
| Get a Discogs master release | GET /discogs/master/26647 | 100% | 0.66 s |
| Get a Discogs release | GET /discogs/release/249504 | 100% | 0.67 s |
| Search the Discogs database | GET /discogs/search?q=Daft+Punk+Discovery&type=release | 100% | 0.66 s |