Bibooks

{
  "type": "object",
  "$defs": {
    "Sort": {
      "enum": [
        "easiest",
        "controversial",
        "length_asc",
        "length_desc",
        "recent",
        "top_rated"
      ],
      "type": "string",
      "title": "Sort",
      "description": "Result order. `easiest`: CEFR level easiest first, unlevelled books last, highest score within a level (the default, and the order of the public library on the website). `recent`: newest first. `top_rated`: highest score first. `controversial`: most votes first. `length_asc` / `length_desc`: by audio duration."
    },
    "Level": {
      "enum": [
        "a1",
        "a2",
        "b1",
        "b2",
        "c1",
        "c2",
        "d1"
      ],
      "type": "string",
      "title": "Level",
      "description": "CEFR difficulty level of a book, easiest first. `d1` is the rung above C2 (expert register); a learner's own level is one of a1..c2."
    },
    "Origin": {
      "enum": [
        "user_typed",
        "ai_generated",
        "gutenberg"
      ],
      "type": "string",
      "title": "Origin",
      "description": "Where a book's text came from: typed or pasted by its publisher (`user_typed`), generated by AI (`ai_generated`), or a public-domain Project Gutenberg title (`gutenberg`)."
    },
    "Audience": {
      "enum": [
        "child",
        "young_adult",
        "adult"
      ],
      "type": "string",
      "title": "Audience",
      "description": "Intended audience age group of a book."
    },
    "Duration": {
      "enum": [
        "under_5",
        "5_to_15",
        "15_to_30",
        "over_30"
      ],
      "type": "string",
      "title": "Duration",
      "description": "Audio length bucket in minutes: under 5, 5 to 15, 15 to 30, or over 30."
    }
  },
  "title": "search_booksArguments",
  "properties": {
    "page": {
      "type": "integer",
      "title": "Page",
      "default": 1,
      "maximum": 10000,
      "minimum": 1,
      "description": "Page number, starting at 1."
    },
    "sort": {
      "$ref": "#/$defs/Sort",
      "default": "easiest",
      "description": "Result order."
    },
    "level": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Level"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Level",
      "default": null,
      "description": "CEFR levels to include."
    },
    "query": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 200
        },
        {
          "type": "null"
        }
      ],
      "title": "Query",
      "default": null,
      "description": "Text to find in titles and authors."
    },
    "origin": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Origin"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Origin",
      "default": null,
      "description": "Text origins to include."
    },
    "audience": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Audience"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Audience",
      "default": null,
      "description": "Audiences to include."
    },
    "duration": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Duration"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Duration",
      "default": null,
      "description": "Audio length buckets to include."
    },
    "page_size": {
      "type": "integer",
      "title": "Page Size",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Books per page."
    },
    "source_language": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 12,
            "minLength": 2
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Language",
      "default": null,
      "description": "Languages the books' original text is written in, i.e. the learner's language."
    },
    "target_language": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 12,
            "minLength": 2
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Target Language",
      "default": null,
      "description": "Languages the books are translated into, i.e. the language being learned."
    }
  }
}