> ## Documentation Index
> Fetch the complete documentation index at: https://rockboxzig.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Full-text search powered by Typesense



## OpenAPI

````yaml /api-reference/openapi.json get /search
openapi: 3.1.0
info:
  title: Rockbox HTTP API
  version: 1.0.0
  summary: >-
    HTTP REST API for rockboxd — playback, library, playlists, devices,
    settings.
  description: >-
    Rockbox Daemon exposes its full feature surface over HTTP REST on port 6063
    (configurable via `ROCKBOX_TCP_PORT`). It complements the GraphQL API on
    :6062 and the gRPC API on :6061 — all three speak to the same in-process
    state.


    All handlers are defined in `crates/server/src/handlers/` and registered in
    `crates/server/src/lib.rs:run_http_server()`.
  contact:
    name: Rockbox Daemon
    url: https://github.com/tsirysndr/rockboxd
  license:
    name: GPL-2.0
    url: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
servers:
  - url: http://localhost:6063
    description: Default local rockboxd
security: []
tags:
  - name: Albums
  - name: Artists
  - name: Tracks
  - name: Search
  - name: Browse
  - name: Player
  - name: Playlist (queue)
  - name: Saved playlists
  - name: Smart playlists
  - name: Track stats
  - name: Devices
  - name: Settings
  - name: System
  - name: Bluetooth
paths:
  /search:
    get:
      tags:
        - Search
      summary: Full-text search powered by Typesense
      operationId: search
      parameters:
        - name: q
          in: query
          schema:
            type: string
          description: Search term
      responses:
        '200':
          description: Matching tracks, albums and artists
          content:
            application/json:
              schema:
                type: object
                properties:
                  tracks:
                    type: array
                    items:
                      $ref: '#/components/schemas/Track'
                  albums:
                    type: array
                    items:
                      $ref: '#/components/schemas/Album'
                  artists:
                    type: array
                    items:
                      $ref: '#/components/schemas/Artist'
              example:
                albums:
                  - album_art: 5e35f1a2c80de5a6cb3f27132f3f81ea.jpg
                    artist: Charli xcx
                    artist_id: cmfcfqx3w002dwg08lrasptzo
                    id: cmffj228r0007wgc70wuvimfc
                    label: null
                    md5: d15421a438be924a9d24969e3b3b3fbc
                    title: Charli
                    year: 2019
                    year_string: '2019-09-13'
                  - album_art: 0cba3a84d1c43731303a54dc03e3e852.jpg
                    artist: Charli xcx
                    artist_id: cmfcfqx3w002dwg08lrasptzo
                    id: cmfpe1csg0008wguw7f4v18j2
                    label: null
                    md5: e46ac9be6763f80e7bcf4328db202e50
                    title: SUCKER
                    year: 2014
                    year_string: '2014-12-16'
                artists: []
                tracks: []
components:
  schemas:
    Track:
      type: object
      properties:
        id:
          type: string
        path:
          type: string
        title:
          type: string
        artist:
          type: string
        album:
          type: string
        album_artist:
          type: string
        composer:
          type: string
        genre:
          type: string
          nullable: true
        year:
          type: integer
          format: int64
          nullable: true
        year_string:
          type: string
          nullable: true
        track_number:
          type: integer
          format: int64
          nullable: true
        disc_number:
          type: integer
          format: int64
        length:
          type: integer
          format: int64
          description: Duration in milliseconds
        filesize:
          type: integer
          format: int64
        bitrate:
          type: integer
          format: int64
        frequency:
          type: integer
          format: int64
        album_id:
          type: string
        artist_id:
          type: string
        genre_id:
          type: string
        album_art:
          type: string
          nullable: true
        md5:
          type: string
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    Album:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        artist:
          type: string
        year:
          type: integer
          format: int32
          nullable: true
        year_string:
          type: string
          nullable: true
        artist_id:
          type: string
        md5:
          type: string
        album_art:
          type: string
          nullable: true
    Artist:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        image:
          type: string
          nullable: true
        bio:
          type: string
          nullable: true

````