Discogs API endpoint
Returns 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.
/discogs/label/{id}Returns a Discogs label profile: profile text, contact info, parent label, and sub-labels. Rate-limited to 25 requests/min per IP.
Path parameters:
id (required) — Discogs label id.Response includes profile, contact_info, parent_label (id, name, present only when the label has a parent), sub_labels[], urls[], images[], data_quality, uri, source_url.
| Field | Filled in, of 183 checked | Values in the sample |
|---|---|---|
| id | 183 | |
| name | 183 | “100% Elvis” and 182 other values |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Discogs label id | 895 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/discogs/label/895" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 895,
"name": "RCA",
"profile": "Multinational label. Label Code: LC 0316 / LC 00316.",
"parent_label": {
"id": 29073,
"name": "Sony Music Entertainment"
},
"sub_labels": [
{
"id": 1099494,
"name": "100% Elvis"
}
],
"data_quality": "Correct",
"uri": "https://www.discogs.com/label/895-RCA",
"source_url": "https://api.discogs.com/labels/895"
}
}Request schema
No body schema
Response schema
#/definitions/discogs.labelResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | discogs.LabelResponse | No | ||||
| data.contact_info | string | No | ||||
| data.data_quality | string | No | ||||
| data.id | integer | No | 895 | |||
| data.images | array | No | Image record, 5 fields: height, type, uri, uri150, width. Described under Discogs Artist API. | |||
| data.name | string | No | RCA | |||
| data.parent_label | discogs.EntityRef | No | ||||
| data.parent_label.active | boolean | No | True when Discogs marks the related artist as currently active. Omitted when inactive or when Discogs gives no status. | |||
| data.parent_label.id | integer | No | Discogs artist id. Use it with the artist endpoint. | |||
| data.parent_label.name | string | No | Name of the artist as Discogs lists it. | |||
| data.profile | string | No | ||||
| data.source_url | string | No | ||||
| data.sub_labels | array | No | ||||
| data.sub_labels[].active | boolean | No | True when Discogs marks the related artist as currently active. Omitted when inactive or when Discogs gives no status. | |||
| data.sub_labels[].id | integer | No | Discogs artist id. Use it with the artist endpoint. | |||
| data.sub_labels[].name | string | No | Name of the artist as Discogs lists it. | |||
| data.uri | string | No | ||||
| data.urls | array | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/discogs/label/895" \
-H "x-api-key: $CRAWLORA_API_KEY"