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