info:
  name: Search Device Catalog
  type: http
  seq: 2
http:
  method: GET
  url: '{{opds_base_url}}/devices/{{device_id}}/search?q=hobbit'

docs: |-
  ## Search Device Catalog
  
    Searches the device's book catalog for matching titles, authors, or series.
  
    **Method:** GET
  
    **Endpoint:** /devices/{device_id}/search
  
    **Authentication:** Required (Device token or Bearer token)
  
    **Path Parameters:**
    - `device_id` (string): Device ID
  
    **Query Parameters:**
    - `q` (string, required): Search query
    - `page` (integer, optional): Page number (default 1)
    - `per_page` (integer, optional): Items per page (default 50)
    - `search_in` (string, optional): Search fields (title, author, series, all)
  
    **Response:**
    - OPDS 2.0 feed with matching book entries
  
    **Status Codes:**
    - 200: Success
    - 400: Invalid query
    - 401: Unauthorized