OpenMusic has two search modes.

Bucketed Search

GET /search

Endpoint reference: searchTop

This endpoint returns grouped search buckets inside one response object.

Possible buckets:

• top
• songs
• artists
• albums
• stations
• playlists

Key parameters:

• term is required
• include selects which buckets are returned
• scoped view[...] and limit[...] control nested resource detail

Typed Search

Typed search endpoints return a paginated result for a single resource type. Search results are ordered by the server's relevance or popularity logic.

• Search Songs
• Search Albums
• Search Artists
• Search Playlists

Objects

• Models: Search Models
• Responses: Search Responses
• Bucketed search response: SearchTopResponse