Global Cross-Category Search API

GET /api/v1/search Performs an aggregated, cross-category search querying all registered catalog modules in parallel.

Query Parameters

Parameter	Type	Required	Description
`q`	`string`	Yes	Search keyword or title query

Example Request

curl -X GET "https://api.mylists.cc/api/v1/search?q=dune"

Example Response (`200 OK`)

{
  "query": "dune",
  "results": {
    "movies": [
      {
        "id": "mov_01j7abc89",
        "category": "movies",
        "title": "Dune: Part Two",
        "director": "Denis Villeneuve",
        "release_year": 2024
      }
    ],
    "books": [
      {
        "id": "bk_01j7book01",
        "category": "books",
        "title": "Dune",
        "author": "Frank Herbert",
        "publication_year": 1965
      }
    ],
    "tvshows": []
  }
}