Raw schema
{
"type": "object",
"properties": {
"query": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Text to find in titles and authors.",
"title": "Query"
},
"target_language": {
"anyOf": [
{
"items": {
"maxLength": 12,
"minLength": 2,
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Languages the books are translated into, i.e. the language being learned.",
"title": "Target Language"
},
"source_language": {
"anyOf": [
{
"items": {
"maxLength": 12,
"minLength": 2,
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Languages the books' original text is written in, i.e. the learner's language.",
"title": "Source Language"
},
"level": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Level"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "CEFR levels to include.",
"title": "Level"
},
"audience": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Audience"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Audiences to include.",
"title": "Audience"
},
"origin": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Origin"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Text origins to include.",
"title": "Origin"
},
"duration": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/Duration"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Audio length buckets to include.",
"title": "Duration"
},
"sort": {
"default": "easiest",
"description": "Result order.",
"enum": [
"easiest",
"controversial",
"length_asc",
"length_desc",
"recent",
"top_rated"
],
"type": "string"
},
"page": {
"default": 1,
"description": "Page number, starting at 1.",
"maximum": 10000,
"minimum": 1,
"title": "Page",
"type": "integer"
},
"page_size": {
"default": 10,
"description": "Books per page.",
"maximum": 50,
"minimum": 1,
"title": "Page Size",
"type": "integer"
}
},
"$defs": {
"Audience": {
"description": "Intended audience age group of a book.",
"enum": [
"child",
"young_adult",
"adult"
],
"title": "Audience",
"type": "string"
},
"Duration": {
"description": "Audio length bucket in minutes: under 5, 5 to 15, 15 to 30, or over 30.",
"enum": [
"under_5",
"5_to_15",
"15_to_30",
"over_30"
],
"title": "Duration",
"type": "string"
},
"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.",
"enum": [
"a1",
"a2",
"b1",
"b2",
"c1",
"c2",
"d1"
],
"title": "Level",
"type": "string"
},
"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`).",
"enum": [
"user_typed",
"ai_generated",
"gutenberg"
],
"title": "Origin",
"type": "string"
}
},
"title": "search_booksArguments"
}