Songs
Get Multiple Songs by OMM Id
Fetch one or more songs by OpenMusicMetadata id using the songs lookup endpoint.
Endpoint
GET /songs
Endpoint reference: getSongs
Use this form when you want canonical lookup through OpenMusicMetadata ids.
Required Query Parameter
| Name | Description | Type | Example |
|---|---|---|---|
omm_ids | Comma-separated OpenMusicMetadata ids | string | z913j3q5cqmeii0d,ab12cd34ef56gh78 |
omm_ids are generally CUID2 identifiers issued by OpenMusicMetadata.
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[albums] | 1-25 | false |
limit[artists] | 1-25 | false |
Responses
| Status | Content Type | Response |
|---|---|---|
200 OK | application/json | SongListResponse |
400 Bad Request | application/json | ErrorResponse |