discogs.database — io.trosa/discogs 0.1.0

get-artist clj

(get-artist client artist-id)

The Artist resource represents a person in the Discogs database who contributed to a Release in some capacity.

Get an artist.

get-artist-masters clj

(get-artist-masters client artist-id)

Returns a list of Masters associated with the Artist.

Get an artist’s master only

get-artist-releases clj

(get-artist-releases client artist-id)

(get-artist-releases client artist-id params)

Returns a list of Releases and Masters associated with the Artist.

Get an artist’s releases

get-label clj

(get-label client label-id)

The Label resource represents a label, company, recording studio, location, or other entity involved with Artists and Releases.

Labels were recently expanded in scope to include things that aren’t labels – the name is an artifact of this history.

Get a label.

get-label-releases clj

(get-label-releases client label-id)

(get-label-releases client label-id params)

Returns a list of Releases associated with the label.

get-master clj

(get-master client master-id)

The Master resource represents a set of similar Releases. Masters (also known as “master releases”) have a “main release” which is often the chronologically earliest.

Get a master release.

get-master-versions clj

(get-master-versions client master-id)

(get-master-versions client master-id params)

Retrieves a list of all Releases that are versions of this master.

get-release clj

(get-release client release-id)

(get-release client release-id currency)

The Release resource represents a particular physical or digital object released by one or more Artists.

Get a release by the id

get-release-community-rating clj

(get-release-community-rating client release-id)

the community release rating endpoint retrieves the average rating and the total number of user ratings for a given release.

retrieves the community release rating average and count.

return: {:release_id 33849456, :rating {:count 633, :average 4.84}}

get-release-rating-by-username clj

(get-release-rating-by-username client release-id username)

the release rating endpoint retrieves, updates, or deletes the rating of a release for a given user.

retrieves the release’s rating for a given user.

return: {:username "memory", :release_id 33849456, :rating 0}

get-release-stats clj

(get-release-stats client release-id)

the release stats endpoint retrieves the total number of “haves” (in the community’s collections) and “wants” (in the community’s wantlists) for a given release.

retrieves the release’s “have” and “want” counts.

return: {:is_offensive false}

search clj

(search client query)

Sends a search request to the Discogs API using the given client and query parameters.

The query parameters are validated against the DiscogsSearchParameters schema, which supports a wide range of search options for the Discogs database.

Parameters:

• client: The API client used to make the request.
• query: A map of search parameters, matching the DiscogsSearchParameters schema.

Supported Query Parameters:

• :q (string, optional): General search query.
• :type (DiscogsResourceType, optional): Filter by resource type (release, master, artist, or label).
• :title (string, optional): Search by combined 'Artist Name - Release Title' field.
• :release_title (string, optional): Search release titles.
• :credit (string, optional): Search release credits.
• :artist (string, optional): Search artist names.
• :anv (string, optional): Search artist ANV (Artist Name Variation).
• :label (string, optional): Search label names.
• :genre (string, optional): Search genres.
• :style (string, optional): Search styles.
• :country (string, optional): Search release country.
• :year (string, optional): Search release year.
• :format (string, optional): Search formats.
• :catno (string, optional): Search catalog number.
• :barcode (string, optional): Search barcodes.
• :track (string, optional): Search track titles.
• :submitter (string, optional): Search submitter username.
• :contributor (string, optional): Search contributor usernames.

Returns:

• On successful validation, returns the result of the API request.
• If validation fails, throws an exception with explanation data.

Example: (search client {:q "Godflesh" :type "artist"})