search

1 endpoint at a glance

Method	Path	Summary
GET	/search	Unified Search

search

---

Unified Search

GET

/search

Unified canonical+Deezer search with per-row user status.

Empty q returns an empty shell — the SPA renders a "type to
search" placeholder for empty inputs, so we never want to do a
full-corpus query.

include_fallback=false skips the Deezer/MusicBrainz lookups and
answers purely from our own canonicals. Those lookups are the only
slow part of this endpoint, so callers that don't render them (the
Library page's in-page search consumes the canonical section only)
should opt out and get a local-Mongo-speed response.

Parameters

Query Parameters

q

Type

string

Default

""

kind

Type

string

Valid values

"all""artist""album""track"

Default

"all"

limit

Type

integer

Default

10

include_fallback

Type

boolean

Default

true

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/search

Playground

Variables

Key

Value

q

kind

limit

include_fallback

Samples

---