{ "openapi": "3.0.1", "info": { "title": "LibriVox Audiobook Scraper", "description": "Search LibriVox's free public-domain audiobook catalog - get full chapter listings with direct MP3 download URLs, readers, cover art, and metadata. No login, no cost.", "version": "1.0", "x-build-id": "ZKB1s9zbuiU4dQrQw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~librivox-audiobook-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-librivox-audiobook-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~librivox-audiobook-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-librivox-audiobook-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~librivox-audiobook-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-librivox-audiobook-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byAuthor", "byGenre", "byIds", "recent" ], "type": "string", "description": "What to fetch.", "default": "search" }, "titleQuery": { "title": "Title search (mode=search)", "type": "string", "description": "Book title to search for. Matches from the start of the title (case-sensitive prefix match) — e.g. `Pride and` matches \"Pride and Prejudice\". An exact full title also works.", "default": "Pride and Prejudice" }, "authorLastName": { "title": "Author last name (mode=byAuthor)", "type": "string", "description": "Exact author last name, case-insensitive (e.g. `Dumas`, `Twain`, `Doyle`). Partial/prefix names are not supported by LibriVox's API." }, "genre": { "title": "Genre (mode=byGenre)", "enum": [ "", "Children's Fiction", "Children's Fiction > Action & Adventure", "Children's Fiction > Animals & Nature", "Children's Fiction > Myths, Legends & Fairy Tales", "Children's Fiction > Family", "Children's Fiction > General", "Children's Fiction > Historical", "Children's Fiction > Poetry", "Children's Fiction > Religion", "Children's Fiction > School", "Children's Fiction > Short works", "Children's Non-fiction", "Children's Non-fiction > Arts", "Children's Non-fiction > General", "Children's Non-fiction > Reference", "Children's Non-fiction > Religion", "Children's Non-fiction > Science", "Children's Non-fiction > History", "Children's Non-fiction > Biography", "Action & Adventure Fiction", "Classics (Greek & Latin Antiquity)", "Crime & Mystery Fiction", "Crime & Mystery Fiction > Detective Fiction", "Culture & Heritage Fiction", "Dramatic Readings", "Epistolary Fiction", "Erotica", "Travel Fiction", "Family Life", "Fantastic Fiction", "Fantastic Fiction > Myths, Legends & Fairy Tales", "Fantastic Fiction > Horror & Supernatural Fiction", "Fantastic Fiction > Gothic Fiction", "Fantastic Fiction > Science Fiction", "Fantastic Fiction > Fantasy Fiction", "Fictional Biographies & Memoirs", "General Fiction", "General Fiction > Published before 1800", "General Fiction > Published 1800 -1900", "General Fiction > Published 1900 onward", "Historical Fiction", "Humorous Fiction", "Literary Fiction", "Nature & Animal Fiction", "Nautical & Marine Fiction", "Plays", "Plays > Comedy", "Plays > Comedy > Satire", "Plays > Drama", "Plays > Drama > Tragedy", "Plays > Romance", "Poetry", "Poetry > Anthologies", "Poetry > Single author", "Poetry > Ballads", "Poetry > Elegies & Odes", "Poetry > Epics", "Poetry > Free Verse", "Poetry > Lyric", "Poetry > Narratives", "Poetry > Sonnets", "Poetry > Multi-version (Weekly and Fortnightly poetry)", "Religious Fiction", "Religious Fiction > Christian Fiction", "Romance", "Sagas", "Satire", "Short Stories", "Short Stories > Anthologies", "Short Stories > Single Author Collections", "Sports Fiction", "Suspense, Espionage, Political & Thrillers", "War & Military Fiction", "Westerns", "*Non-fiction", "*Non-fiction > War & Military", "*Non-fiction > Animals", "*Non-fiction > Art, Design & Architecture", "*Non-fiction > Bibles", "*Non-fiction > Bibles > American Standard Version", "*Non-fiction > Bibles > World English Bible", "*Non-fiction > Bibles > King James Version", "*Non-fiction > Bibles > Weymouth New Testament", "*Non-fiction > Bibles > Douay-Rheims Version", "*Non-fiction > Bibles > Young's Literal Translation", "*Non-fiction > Biography & Autobiography", "*Non-fiction > Biography & Autobiography > Memoirs", "*Non-fiction > Business & Economics", "*Non-fiction > Crafts & Hobbies", "*Non-fiction > Education", "*Non-fiction > Education > Language learning", "*Non-fiction > Essays & Short Works", "*Non-fiction > Family & Relationships", "*Non-fiction > Health & Fitness", "*Non-fiction > History", "*Non-fiction > History > Antiquity", "*Non-fiction > History > Middle Ages/Middle History", "*Non-fiction > History > Early Modern", "*Non-fiction > History > Modern (19th C)", "*Non-fiction > History > Modern (20th C)", "*Non-fiction > House & Home", "*Non-fiction > House & Home > Cooking", "*Non-fiction > House & Home > Gardening", "*Non-fiction > Humor", "*Non-fiction > Law", "*Non-fiction > Literary Collections", "*Non-fiction > Literary Collections > Essays", "*Non-fiction > Literary Collections > Short non-fiction", "*Non-fiction > Literary Collections > Letters", "*Non-fiction > Literary Criticism", "*Non-fiction > Mathematics", "*Non-fiction > Medical", "*Non-fiction > Music", "*Non-fiction > Nature", "*Non-fiction > Performing Arts", "*Non-fiction > Philosophy", "*Non-fiction > Philosophy > Ancient", "*Non-fiction > Philosophy > Medieval", "*Non-fiction > Philosophy > Early Modern", "*Non-fiction > Philosophy > Modern", "*Non-fiction > Philosophy > Contemporary", "*Non-fiction > Philosophy > Atheism & Agnosticism", "*Non-fiction > Political Science", "*Non-fiction > Psychology", "*Non-fiction > Reference", "*Non-fiction > Religion", "*Non-fiction > Religion > Christianity - Commentary", "*Non-fiction > Religion > Christianity - Biographies", "*Non-fiction > Religion > Christianity - Other", "*Non-fiction > Religion > Other religions", "*Non-fiction > Science", "*Non-fiction > Science > Astronomy, Physics & Mechanics", "*Non-fiction > Science > Chemistry", "*Non-fiction > Science > Earth Sciences", "*Non-fiction > Science > Life Sciences", "*Non-fiction > Self-Help", "*Non-fiction > Social Science (Culture & Anthropology)", "*Non-fiction > Sports & Recreation", "*Non-fiction > Sports & Recreation > Games", "*Non-fiction > Technology & Engineering", "*Non-fiction > Technology & Engineering > Transportation", "*Non-fiction > Travel & Geography", "*Non-fiction > Travel & Geography > Exploration", "*Non-fiction > True Crime", "*Non-fiction > Writing & Linguistics", "Asian Antiquity", "Periodicals & Magazines" ], "type": "string", "description": "Browse audiobooks by LibriVox's genre taxonomy.", "default": "" }, "sinceDate": { "title": "Catalogued since (mode=recent)", "type": "string", "description": "Return audiobooks LibriVox catalogued on or after this date, format `YYYY-MM-DD`. Required for `recent` mode." }, "bookIds": { "title": "Book IDs (mode=byIds)", "type": "array", "description": "LibriVox numeric book/project IDs (e.g. `52`, `47`). Find them via the other modes' `bookId` output field.", "default": [], "items": { "type": "string" } }, "language": { "title": "Language filter", "enum": [ "", "English", "French", "German", "Italian", "Spanish", "Acehnese", "Afrikaans", "Aleut", "Ancient Greek", "Arabic", "Assamese", "Balinese", "Belarusian", "Bengali", "Bisaya/Cebuano", "Braj", "Buginese", "Bulgarian", "Cantonese Chinese", "Catalan", "Chinese", "Church Slavonic", "Croatian", "Czech", "Danish", "Dholuo/Luo", "Dutch", "Esperanto", "Faroese", "Finnish", "Friulano", "Galician", "Gamilaraay", "Garo", "Gascon/Occitan", "Greek", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Iloko", "Indonesian", "Interlingua", "Irish", "Iroquoian", "Japanese", "Javanese", "Kapampangan", "Khasi", "Korean", "Kurdish", "Latin", "Latvian", "Lithuanian", "Low German", "Luxembourgish", "Macedonian", "Malay", "Maltese", "Maori", "Marathi", "Mayan Languages", "Middle English", "Minangkabau", "Multilingual", "Nahuatl", "Neapolitan-Calabrian", "Nepali", "North American Indian (undetermined dialect)", "Norwegian", "Nynorsk", "Occitan", "Old English", "Old Javanese", "Old Norse", "Old Sundanese", "Old Tupi", "Oriya", "Other/Uncoded", "Palatine German", "Persian/Farsi", "Polish", "Portuguese", "Rajasthani", "Romanian", "Russian", "Sanskrit", "Scottish Gaelic", "Serbian", "Slovak", "Slovenian", "Sundanese", "Swahili", "Swedish", "Tagalog", "Tamil", "Telugu", "Turkish", "Ukrainian", "Urdu", "Vietnamese", "Volapük", "Walloon", "Welsh", "Western Frisian", "Yiddish" ], "type": "string", "description": "Only emit audiobooks recorded in this language.", "default": "" }, "minDurationSeconds": { "title": "Minimum total duration (seconds)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop audiobooks shorter than this many seconds." }, "maxDurationSeconds": { "title": "Maximum total duration (seconds)", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Drop audiobooks longer than this many seconds." }, "copyrightYearMin": { "title": "Copyright year (min)", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Drop books first copyrighted before this year." }, "copyrightYearMax": { "title": "Copyright year (max)", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Drop books first copyrighted after this year." }, "containsKeyword": { "title": "Must contain keyword", "type": "string", "description": "Only emit audiobooks whose title, description, author name, or genre contains this keyword (case-insensitive)." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on the number of records emitted.", "default": 30 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }