Overview

Get Albums by Tag Groups

Finds albums whose tags satisfy grouped criteria: comma-separated tags in a group must all match (AND), and colon-separated groups are OR-ed together. Results include album, artist, primary release, and the tags that matched the query.

Use this when: building advanced album browsing, such as curated collections, combined genre and mood filters, or screens where users combine multiple tag requirements. For a simple single-tag album grid with sort options, use Get Albums By Tag instead; this endpoint is for AND/OR tag rules and includes which tags matched on each album.

Security Model

API Key Authentication

Header Parameters

StoreIdstring Required

StoreId API Key provided by Tuned Global for accessing the service

Countrystring

Market used to filter albums; defaults to the store's default country when omitted

Query Parameters

groupsstring Required

Groups of tags. Groups are delimited by ':' and tags within a group are delimited by ','

typesstring

The tags of specified types to return in the artist object. Types are delimited by ','

Enum values:

GenreCountryOfOriginDeceasedTargetTimeUserMusiioGenreMusiioMoodMusiioEnergyRHGenreRHSubGenre

... 12 other enums

offsetinteger

First row in the page (default 1)

countinteger

Number of rows to return (default 10)

Response

200

Object

Response Attributes

Offsetinteger

The offset specifies the number of items that should be skipped from the beginning of the dataset before fetching the next page of results.

Totalinteger

The total refers to the aggregate of all the items in the paged results

Countinteger

The number of items in the results

readOnly

Resultsarray

The iterable objects returned

Show child attributes

Sections

Get Albums by Tag Groups

Security Model

Header Parameters

Query Parameters

... 12 other enums

ResponseExpand all

Response Attributes

Response

Response