Search
Search Albums
Search albums with pagination and genre filtering.
Endpoint
GET /search/albums
Endpoint reference: searchAlbums
Required Query Parameter
| Name | Description | Type | Example |
|---|---|---|---|
term | Search term | string | term=in rainbows |
Optional Query Parameters
Scoped parameters like view[...] and limit[...] can shape included relationships.
| Name | Values | Required |
|---|---|---|
lang | locale string | false |
include | artists, tracks | false |
view | minimal | false |
view[albums] | minimal | false |
view[artists] | minimal | false |
view[songs] | minimal | false |
limit | 1-25 | false |
offset | 0+ | false |
filter[genres] | comma-separated genres | false |
limit[artists] | 1-25 | false |
limit[tracks] | 1-25 | false |
Responses
| Status | Content Type | Response |
|---|---|---|
200 OK | application/json | SearchAlbumsResponse |
400 Bad Request | application/json | ErrorResponse |