Wolne Lektury

Read Wolne Lektury, the free digital library of Polish literature: several thousand works, most of them school set texts, each with an ebook in every common format and often a human-read audiobook. Search by title or author, browse by epoch, kind or genre, pull a work's full text or download links into a workflow, and search the library's hand-made index of literary themes down to the individual passage. No account or API key is required.

Actions

Action	What it does
Find fragments	Find the passages the library's editors have indexed under a theme (love, death, betrayal, the passing of time) and, optionally, narrowed to one author, epoch, kind or genre.
Get a book	Fetch one work by its slug, with its authors and translators, its epoch, kind and genre, a download link for every format it is published in, every audiobook file recorded for it, its cover, and the works it contains or belongs to.
Get a collection	Fetch one curated collection: what it is for, every work on it, and the authors it is built around.
Get a fragment	Fetch one indexed passage: its words, the work and author it comes from, and every theme the library's editors filed it under.
Get a tag	Fetch one author, epoch, kind, genre or theme, with the editorial description the library writes for it: a biographical note for an author, an account of the period for an epoch, a definition for a genre.
Get book text	Download the full text of a work, ready to summarise, quote or search.
Get download links	List every file Wolne Lektury publishes for a work (plain text, PDF, EPUB, Kindle, FictionBook, HTML and the library's own source XML, plus every audiobook file), each with a readable label and a direct URL.
List books	Browse one of the catalogue's shelves: every work, whole works only, the ones with a human-read audiobook, the ones with a DAISY accessible audiobook, the editors' picks, or the most recently published.
List collections	List the library's curated collections: the reading lists its editors put together, such as the set texts for a school year or a selection on one subject.
List tags	List the library's authors, literary epochs, kinds, genres or themes, each with the slug every other action's filters take.
Search books	Search the Wolne Lektury catalogue by title and by author.

Find fragments

Find the passages the library's editors have indexed under a theme (love, death, betrayal, the passing of time) and, optionally, narrowed to one author, epoch, kind or genre. This index is hand-made and goes down to the passage, so it answers 'what does Polish Romanticism say about the homeland' rather than 'which books mention it'. At least one filter is required. A listing names each passage; turn on 'Include the text' to fetch the words too. Wolne Lektury serves this listing whole, so a broad theme is cut to the number of results you ask for and 'total_count' reports how many there were.

Inputs

Themethemetext: Only passages indexed under this theme, given as a slug such as 'zabawa' (fun) or 'milosc' (love). List tags for 'theme' returns every slug the library accepts.
Authorauthortext: Only works by this author, given as a slug such as 'adam-mickiewicz'. List tags for 'author' returns every slug the library accepts.
Epochepochtext: Only works from this literary epoch, given as a slug. List tags for 'epoch' returns every slug the library accepts.
Kindliterary_kindtext: Only works of this literary kind -- poetry, prose or drama -- given as a slug. List tags for 'kind' returns every slug the library accepts.
Genregenretext: Only works of this genre, given as a slug. List tags for 'genre' returns every slug the library accepts.
Number of fragmentsmax_resultsnumber: How many passages to return, from 1 to 500. Defaults to 50. Wolne Lektury serves this listing in one piece with no page size of its own, so a broad theme sends every passage carrying it; 'total_count' says how many it sent.From 1 to 500.
Include the textinclude_texttrue/false: Fetch each passage's words as well as its address. The listing itself does not carry them, so this costs one extra request per passage. Off by default.Default: false.
How many texts to fetchmax_textsnumber: With 'Include the text' on, how many passages to fetch the words for, from 1 to 25. Defaults to 10. The rest are still listed, just without their text.From 1 to 25.

Outputs

filterslist
fragmentslist
has_moretrue/false
result_countnumber
texts_fetchednumber
total_countnumber

Example output

{
  "filters": [
    {
      "category": "author",
      "slug": "william-shakespeare"
    },
    {
      "category": "theme",
      "slug": "zabawa"
    }
  ],
  "fragments": [
    {
      "anchor": "1290526312912-3814598192",
      "api_url": "https://wolnelektury.pl/api/books/sen-nocy-letniej/fragments/1290526312912-3814598192/",
      "book": {
        "api_url": "https://wolnelektury.pl/api/books/sen-nocy-letniej/",
        "author": "William Shakespeare",
        "cover_color": "#a6820a",
        "cover_thumb_url": "https://wolnelektury.pl/media/cover_thumb/studnia-i-wahadlo.jpg",
        "cover_url": "https://wolnelektury.pl/media/cover/studnia-i-wahadlo.jpg",
        "epoch": "Romantyzm",
        "epub_url": null,
        "fb2_url": null,
        "genre": "Komedia",
        "has_audio": true,
        "key": null,
        "kind": "Dramat",
        "mobi_url": null,
        "pdf_url": null,
        "simple_thumb_url": "https://wolnelektury.pl/media/cover_api_thumb/studnia-i-wahadlo.jpg",
        "slug": "sen-nocy-letniej",
        "sort_key": "edgar allan poe$studnia i wahadlo$1",
        "title": "Sen nocy letniej",
        "txt_url": null,
        "url": "https://wolnelektury.pl/katalog/lektura/sen-nocy-letniej/"
      },
      "book_author": "William Shakespeare",
      "book_slug": "sen-nocy-letniej",
      "book_title": "Sen nocy letniej",
      "text": "Czego\u017c chcesz, duszo? Zabawy czy ta\u0144ca?",
      "text_html": "<p>Czego\u017c chcesz, duszo? Zabawy czy ta\u0144ca?</p>",
      "themes": [
        {
          "api_url": "https://wolnelektury.pl/api/themes/zabawa/",
          "name": "Zabawa",
          "slug": "zabawa",
          "url": "https://wolnelektury.pl/katalog/motyw/zabawa/"
        }
      ],
      "url": "https://wolnelektury.pl/katalog/lektura/sen-nocy-letniej.html#m1290526312912-3814598192"
    }
  ],
  "has_more": false,
  "result_count": 1,
  "texts_fetched": 1,
  "total_count": 1
}

Get a book

Fetch one work by its slug, with its authors and translators, its epoch, kind and genre, a download link for every format it is published in, every audiobook file recorded for it, its cover, and the works it contains or belongs to.

Inputs

WorkslugtextRequired: The work's slug: the last part of its address on wolnelektury.pl, for example 'studnia-i-wahadlo' in https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/. Search books and List books both return this as each result's 'slug'.

Outputs

bookobject

Example output

{
  "book": {
    "api_url": "https://wolnelektury.pl/api/books/studnia-i-wahadlo/",
    "audio_length": "0:47",
    "author_names": [
      "Edgar Allan Poe"
    ],
    "authors": [
      {
        "api_url": "https://wolnelektury.pl/api/authors/edgar-allan-poe/",
        "name": "Edgar Allan Poe",
        "slug": "edgar-allan-poe",
        "url": "https://wolnelektury.pl/katalog/autor/edgar-allan-poe/"
      }
    ],
    "children": [],
    "cover_color": "#a6820a",
    "cover_thumb_url": "https://wolnelektury.pl/media/cover_thumb/studnia-i-wahadlo.jpg",
    "cover_url": "https://wolnelektury.pl/media/cover/studnia-i-wahadlo.jpg",
    "epochs": [
      {
        "api_url": "https://wolnelektury.pl/api/epochs/romantyzm/",
        "name": "Romantyzm",
        "slug": "romantyzm",
        "url": "https://wolnelektury.pl/katalog/epoka/romantyzm/"
      }
    ],
    "epub_url": "https://wolnelektury.pl/media/book/epub/studnia-i-wahadlo.epub",
    "fb2_url": "https://wolnelektury.pl/media/book/fb2/studnia-i-wahadlo.fb2",
    "genres": [
      {
        "api_url": "https://wolnelektury.pl/api/genres/opowiadanie/",
        "name": "Opowiadanie",
        "slug": "opowiadanie",
        "url": "https://wolnelektury.pl/katalog/gatunek/opowiadanie/"
      }
    ],
    "has_audio": true,
    "html_url": "https://wolnelektury.pl/media/html/studnia-i-wahadlo.html",
    "isbn_epub": null,
    "isbn_mobi": null,
    "isbn_pdf": null,
    "kinds": [
      {
        "api_url": "https://wolnelektury.pl/api/kinds/epika/",
        "name": "Epika",
        "slug": "epika",
        "url": "https://wolnelektury.pl/katalog/rodzaj/epika/"
      }
    ],
    "language": "pol",
    "media": [
      {
        "artist": "Masza Bogucka",
        "director": "Anna Rozenfeld",
        "format": "MP3 audio",
        "name": "Studnia i wahad\u0142o",
        "type": "mp3",
        "url": "https://wolnelektury.pl/media/book/mp3/studnia-i-wahadlo.mp3"
      }
    ],
    "mobi_url": "https://wolnelektury.pl/media/book/mobi/studnia-i-wahadlo.mobi",
    "parent": null,
    "pdf_url": "https://wolnelektury.pl/media/book/pdf/studnia-i-wahadlo.pdf",
    "preview": false,
    "simple_cover_url": "https://wolnelektury.pl/media/simple_cover/studnia-i-wahadlo.jpg",
    "simple_thumb_url": "https://wolnelektury.pl/media/cover_api_thumb/studnia-i-wahadlo.jpg",
    "slug": "studnia-i-wahadlo",
    "teaser": {
      "html": "<p>D\u0142uga, straszliwa m\u0119ka konania odj\u0119\u0142a mi si\u0142y...</p>",
      "text": "D\u0142uga, straszliwa m\u0119ka konania odj\u0119\u0142a mi si\u0142y...",
      "title": "Edgar Allan Poe, Studnia i wahad\u0142o"
    },
    "title": "Studnia i wahad\u0142o",
    "translator_names": [
      "Boles\u0142aw Le\u015bmian"
    ],
    "txt_url": "https://wolnelektury.pl/media/book/txt/studnia-i-wahadlo.txt",
    "url": "https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/",
    "xml_url": "https://wolnelektury.pl/media/xml/studnia-i-wahadlo.xml"
  }
}

Get a collection

Fetch one curated collection: what it is for, every work on it, and the authors it is built around. List collections returns the slug this takes.

Inputs

CollectionslugtextRequired: The collection's slug. List collections returns this as each result's 'slug'.

Outputs

authorslist
book_countnumber
bookslist
collectionobject

Example output

{
  "authors": [
    {
      "api_url": "https://wolnelektury.pl/api/authors/edgar-allan-poe/",
      "name": "Edgar Allan Poe",
      "slug": "edgar-allan-poe",
      "url": "https://wolnelektury.pl/katalog/autor/edgar-allan-poe/"
    }
  ],
  "book_count": 1,
  "books": [
    {
      "api_url": "https://wolnelektury.pl/api/books/studnia-i-wahadlo/",
      "author": "Edgar Allan Poe",
      "cover_color": "#a6820a",
      "cover_thumb_url": "https://wolnelektury.pl/media/cover_thumb/studnia-i-wahadlo.jpg",
      "cover_url": "https://wolnelektury.pl/media/cover/studnia-i-wahadlo.jpg",
      "epoch": "Romantyzm",
      "epub_url": null,
      "fb2_url": null,
      "genre": "Opowiadanie",
      "has_audio": true,
      "key": null,
      "kind": "Epika",
      "mobi_url": null,
      "pdf_url": null,
      "simple_thumb_url": "https://wolnelektury.pl/media/cover_api_thumb/studnia-i-wahadlo.jpg",
      "slug": "studnia-i-wahadlo",
      "sort_key": "edgar allan poe$studnia i wahadlo$1",
      "title": "Studnia i wahad\u0142o",
      "txt_url": null,
      "url": "https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/"
    }
  ],
  "collection": {
    "api_url": "https://wolnelektury.pl/api/collections/lektury-liceum/",
    "description": "Utwory omawiane w liceum i technikum.",
    "description_html": "<p>Utwory omawiane w liceum i technikum.</p>",
    "slug": "lektury-liceum",
    "title": "Lektury liceum",
    "url": "https://wolnelektury.pl/katalog/lektury/lektury-liceum/"
  }
}

Get a fragment

Fetch one indexed passage: its words, the work and author it comes from, and every theme the library's editors filed it under. Find fragments returns the work and the anchor this takes. The passage is stored as web page markup, so it comes back both as readable text and, as 'text_html', with the original markup and its emphasis intact.

Inputs

Workbook_slugtextRequired: The slug of the work the passage comes from. Find fragments returns this as each result's 'book_slug'.
AnchoranchortextRequired: The passage's anchor within the work. Find fragments returns this as each result's 'anchor'.

Outputs

fragmentobject

Example output

{
  "fragment": {
    "anchor": "1290526312912-3814598192",
    "api_url": "https://wolnelektury.pl/api/books/sen-nocy-letniej/fragments/1290526312912-3814598192/",
    "book": {
      "api_url": "https://wolnelektury.pl/api/books/sen-nocy-letniej/",
      "author": "William Shakespeare",
      "cover_color": "#a6820a",
      "cover_thumb_url": "https://wolnelektury.pl/media/cover_thumb/studnia-i-wahadlo.jpg",
      "cover_url": "https://wolnelektury.pl/media/cover/studnia-i-wahadlo.jpg",
      "epoch": "Romantyzm",
      "epub_url": null,
      "fb2_url": null,
      "genre": "Komedia",
      "has_audio": true,
      "key": null,
      "kind": "Dramat",
      "mobi_url": null,
      "pdf_url": null,
      "simple_thumb_url": "https://wolnelektury.pl/media/cover_api_thumb/studnia-i-wahadlo.jpg",
      "slug": "sen-nocy-letniej",
      "sort_key": "edgar allan poe$studnia i wahadlo$1",
      "title": "Sen nocy letniej",
      "txt_url": null,
      "url": "https://wolnelektury.pl/katalog/lektura/sen-nocy-letniej/"
    },
    "book_author": "William Shakespeare",
    "book_slug": "sen-nocy-letniej",
    "book_title": "Sen nocy letniej",
    "text": "Czego\u017c chcesz, duszo? Zabawy czy ta\u0144ca?",
    "text_html": "<p>Czego\u017c chcesz, duszo? Zabawy czy ta\u0144ca?</p>",
    "themes": [
      {
        "api_url": "https://wolnelektury.pl/api/themes/zabawa/",
        "name": "Zabawa",
        "slug": "zabawa",
        "url": "https://wolnelektury.pl/katalog/motyw/zabawa/"
      }
    ],
    "url": "https://wolnelektury.pl/katalog/lektura/sen-nocy-letniej.html#m1290526312912-3814598192"
  }
}

Get a tag

Fetch one author, epoch, kind, genre or theme, with the editorial description the library writes for it: a biographical note for an author, an account of the period for an epoch, a definition for a genre. Use it to explain a term a search or a listing returned. The library writes these notes as web page markup, so they come back both as readable text and, as 'description_html', in the original markup.

Inputs

VocabularycategorytextRequired: Which vocabulary the term belongs to.One of: author (Authors), epoch (Epochs (Romanticism, Positivism, …)), kind (Kinds (poetry, prose, drama)), genre (Genres (sonnet, novel, fable, …)), theme (Themes (the passage-level index)).
TermslugtextRequired: The term's slug, such as 'edgar-allan-poe' or 'romantyzm'. List tags returns this as each result's 'slug'.

Outputs

tagobject

Example output

{
  "tag": {
    "adjective_feminine_singular": null,
    "adjective_nonmasculine_plural": null,
    "api_url": "https://wolnelektury.pl/api/authors/edgar-allan-poe/",
    "category": "author",
    "collective_noun": null,
    "description": "Ur. 19 stycznia 1809 w Bostonie\n\nAmeryka\u0144ski poeta, nowelista i krytyk literacki, prekursor literatury grozy i powie\u015bci detektywistycznej.",
    "description_html": "<dl><dt>Ur.</dt><dd>19 stycznia 1809 w Bostonie</dd></dl><p>Ameryka\u0144ski poeta, nowelista i krytyk literacki, prekursor literatury grozy i powie\u015bci detektywistycznej.</p>",
    "epoch_specific": null,
    "genitive": "Edgara Allana Poe",
    "name": "Edgar Allan Poe",
    "plural": null,
    "slug": "edgar-allan-poe",
    "sort_key": "poe, edgar allan",
    "url": "https://wolnelektury.pl/katalog/autor/edgar-allan-poe/"
  }
}

Get book text

Download the full text of a work, ready to summarise, quote or search. The file opens with the author and the title and closes with the library's licence and provenance notice; the notice is removed by default, and the text is cut off at the character limit you set.

Inputs

WorkslugtextRequired: The work's slug: the last part of its address on wolnelektury.pl, for example 'studnia-i-wahadlo' in https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/. Search books and List books both return this as each result's 'slug'.
Maximum charactersmax_charactersnumber: How much of the text to return, from 1,000 to 500,000 characters. Defaults to 50,000 (roughly 25 pages). 'truncated' tells you whether the work was longer than this.From 1000 to 500000.
Remove the Wolne Lektury licence noticestrip_licence_footertrue/false: Strip the licence, source and editorial notice the library appends after the end of the work, so only the work itself is returned. On by default.Default: true.

Outputs

author_nameslist
charactersnumber
licence_footer_removedtrue/false
slugtext
source_urltext
texttext
titletext
truncatedtrue/false

Example output

{
  "author_names": [
    "Edgar Allan Poe"
  ],
  "characters": 50000,
  "licence_footer_removed": true,
  "slug": "studnia-i-wahadlo",
  "source_url": "https://wolnelektury.pl/media/book/txt/studnia-i-wahadlo.txt",
  "text": "Edgar Allan Poe\n\nStudnia i wahad\u0142o\n\nD\u0142uga, straszliwa m\u0119ka konania odj\u0119\u0142a mi si\u0142y.",
  "title": "Studnia i wahad\u0142o",
  "truncated": true
}

Get download links

List every file Wolne Lektury publishes for a work (plain text, PDF, EPUB, Kindle, FictionBook, HTML and the library's own source XML, plus every audiobook file), each with a readable label and a direct URL. Pick a format to also get its URL on its own, ready to hand to a download step. An audiobook is normally one file per chapter, so a chosen audio format returns the whole list as well as the first file.

Inputs

WorkslugtextRequired: The work's slug: the last part of its address on wolnelektury.pl, for example 'studnia-i-wahadlo' in https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/. Search books and List books both return this as each result's 'slug'.
Format to selectfile_formattext: Optional. Pick a format to have its URL returned on its own as 'selected_url'. The full list of files is returned either way.One of: txt (Plain text), pdf, epub, mobi (Kindle (MOBI)), fb2 (FictionBook 2), html, xml (Source XML (Wolne Lektury markup)), mp3 (MP3 audio), ogg (Ogg Vorbis audio), daisy (DAISY (accessible audiobook)), audio.epub (EPUB with audio), sync (Audio/text synchronisation file).

Outputs

authortext
has_audiotrue/false
link_countnumber
linkslist
selected_formattext
selected_urltext
selected_urlslist
slugtext
titletext
urltext

Example output

{
  "author": "Edgar Allan Poe",
  "has_audio": true,
  "link_count": 3,
  "links": [
    {
      "format": "txt",
      "kind": "ebook",
      "label": "Plain text",
      "name": null,
      "url": "https://wolnelektury.pl/media/book/txt/studnia-i-wahadlo.txt"
    },
    {
      "format": "epub",
      "kind": "ebook",
      "label": "EPUB",
      "name": null,
      "url": "https://wolnelektury.pl/media/book/epub/studnia-i-wahadlo.epub"
    },
    {
      "format": "mp3",
      "kind": "media",
      "label": "MP3 audio",
      "name": "Studnia i wahad\u0142o",
      "url": "https://wolnelektury.pl/media/book/mp3/studnia-i-wahadlo.mp3"
    }
  ],
  "selected_format": "epub",
  "selected_url": "https://wolnelektury.pl/media/book/epub/studnia-i-wahadlo.epub",
  "selected_urls": [
    "https://wolnelektury.pl/media/book/epub/studnia-i-wahadlo.epub"
  ],
  "slug": "studnia-i-wahadlo",
  "title": "Studnia i wahad\u0142o",
  "url": "https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/"
}

List books

Browse one of the catalogue's shelves: every work, whole works only, the ones with a human-read audiobook, the ones with a DAISY accessible audiobook, the editors' picks, or the most recently published. Narrow any of the first four by author, epoch, kind and genre together. Two of the shelves return each work's download links in place of its epoch, kind, genre and audio flag: 'has_download_links' on the result says which shape came back.

Inputs

Shelfcataloguetext: Which listing to read. Defaults to every work.One of: books (Every work (default)), parent_books (Whole works only, not their parts), audiobooks (Works with a human-read audiobook), daisy (Works with a DAISY accessible audiobook), ebooks (Every work, with download links instead of tags), parent_ebooks (Whole works only, with download links instead of tags), recommended (Editors' picks (takes no filters)), newest (Most recently published (takes no filters or paging)).
Authorauthortext: Only works by this author, given as a slug such as 'adam-mickiewicz'. List tags for 'author' returns every slug the library accepts.
Epochepochtext: Only works from this literary epoch, given as a slug. List tags for 'epoch' returns every slug the library accepts.
Kindliterary_kindtext: Only works of this literary kind -- poetry, prose or drama -- given as a slug. List tags for 'kind' returns every slug the library accepts.
Genregenretext: Only works of this genre, given as a slug. List tags for 'genre' returns every slug the library accepts.
Number of workscountnumber: How many works to return, from 1 to 200. Defaults to 50. This is always sent: a shelf asked without it answers with the entire catalogue.From 1 to 200.
Continue afteraftertext: Feed the 'next_after' value from a previous run back in here to get the next page. The 'newest' shelf cannot be paged this way.

Outputs

bookslist
cataloguetext
filterslist
has_download_linkstrue/false
has_moretrue/false
next_aftertext
result_countnumber

Example output

{
  "books": [
    {
      "api_url": "https://wolnelektury.pl/api/books/studnia-i-wahadlo/",
      "author": "Edgar Allan Poe",
      "cover_color": "#a6820a",
      "cover_thumb_url": "https://wolnelektury.pl/media/cover_thumb/studnia-i-wahadlo.jpg",
      "cover_url": "https://wolnelektury.pl/media/cover/studnia-i-wahadlo.jpg",
      "epoch": "Romantyzm",
      "epub_url": null,
      "fb2_url": null,
      "genre": "Opowiadanie",
      "has_audio": true,
      "key": null,
      "kind": "Epika",
      "mobi_url": null,
      "pdf_url": null,
      "simple_thumb_url": "https://wolnelektury.pl/media/cover_api_thumb/studnia-i-wahadlo.jpg",
      "slug": "studnia-i-wahadlo",
      "sort_key": "edgar allan poe$studnia i wahadlo$1",
      "title": "Studnia i wahad\u0142o",
      "txt_url": null,
      "url": "https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/"
    }
  ],
  "catalogue": "books",
  "filters": [
    {
      "category": "author",
      "slug": "edgar-allan-poe"
    }
  ],
  "has_download_links": false,
  "has_more": false,
  "next_after": null,
  "result_count": 1
}

List collections

List the library's curated collections: the reading lists its editors put together, such as the set texts for a school year or a selection on one subject. Each comes back with the slug Get a collection takes.

Inputs

None.

Outputs

collectionslist
result_countnumber

Example output

{
  "collections": [
    {
      "api_url": "https://wolnelektury.pl/api/collections/lektury-liceum/",
      "description": "Utwory omawiane w liceum i technikum.",
      "description_html": "<p>Utwory omawiane w liceum i technikum.</p>",
      "slug": "lektury-liceum",
      "title": "Lektury liceum",
      "url": "https://wolnelektury.pl/katalog/lektury/lektury-liceum/"
    }
  ],
  "result_count": 1
}

List the library's authors, literary epochs, kinds, genres or themes, each with the slug every other action's filters take. This is where those slugs come from: the library's vocabularies are curated by its editors, so nothing else can be relied on to spell them. Terms come back in slug order, so a large vocabulary can be walked a page at a time with 'Continue after'.

Inputs

VocabularycategorytextRequired: Which of the library's vocabularies to list.One of: author (Authors), epoch (Epochs (Romanticism, Positivism, …)), kind (Kinds (poetry, prose, drama)), genre (Genres (sonnet, novel, fable, …)), theme (Themes (the passage-level index)).
Number of termscountnumber: How many terms to return, from 1 to 1,000. Defaults to 100. Wolne Lektury serves a vocabulary in one piece with no page size of its own, so the list is cut to size here and 'total_count' says how many terms there are in all.From 1 to 1000.
Continue afteraftertext: Feed the 'next_after' value from a previous run back in here to get the next page. Leave empty for the first page.

Outputs

categorytext
has_moretrue/false
next_aftertext
result_countnumber
tagslist
total_countnumber

Example output

{
  "category": "author",
  "has_more": false,
  "next_after": null,
  "result_count": 1,
  "tags": [
    {
      "api_url": "https://wolnelektury.pl/api/authors/edgar-allan-poe/",
      "name": "Edgar Allan Poe",
      "slug": "edgar-allan-poe",
      "url": "https://wolnelektury.pl/katalog/autor/edgar-allan-poe/"
    }
  ],
  "total_count": 1
}

Search books

Search the Wolne Lektury catalogue by title and by author. Words match from the start of a word, so 'pan' finds 'Pan Tadeusz'; works whose author matched are returned before works whose title did. Every filter is optional and they combine: narrow to an author, an epoch, a kind or a genre, to works that have an audiobook, or to the ones Polish schools set as required reading.

Inputs

Search wordssearchtext: Text to match against titles and author names, at least three characters long. Leave empty to browse with the filters alone.
Authorsauthorslist: Only works by any of these authors, given as slugs such as 'adam-mickiewicz'. Unlike List books, several may be given and a work matching any one of them is returned. List tags for 'author' returns the slugs.
Epochsepochslist: Only works from any of these literary epochs, given as slugs. List tags for 'epoch' returns the slugs.
Kindskindslist: Only works of any of these literary kinds -- poetry, prose or drama -- given as slugs. List tags for 'kind' returns the slugs.
Genresgenreslist: Only works of any of these genres, given as slugs. List tags for 'genre' returns the slugs.
Has an audiobookaudiobooktrue/false: Set to true for only works with a recorded audiobook, false for only works without one. Leave empty for both.
School set textschool_readingtrue/false: Set to true for only the works Polish schools set as required reading (the library's 'lektura' flag), false for only the rest. Leave empty for both.
Number of resultscountnumber: How many works to return, from 1 to 200. Defaults to 50.From 1 to 200.
Continue afteraftertext: Feed the 'next_after' value from a previous run back in here to get the next page. Leave empty for the first page.

Outputs

bookslist
has_moretrue/false
next_aftertext
result_countnumber
searchtext

Example output

{
  "books": [
    {
      "api_url": "https://wolnelektury.pl/api/books/studnia-i-wahadlo/",
      "author": "Edgar Allan Poe",
      "cover_color": "#a6820a",
      "cover_thumb_url": "https://wolnelektury.pl/media/cover_thumb/studnia-i-wahadlo.jpg",
      "cover_url": "https://wolnelektury.pl/media/cover/studnia-i-wahadlo.jpg",
      "epoch": "Romantyzm",
      "epub_url": null,
      "fb2_url": null,
      "genre": "Opowiadanie",
      "has_audio": true,
      "key": null,
      "kind": "Epika",
      "mobi_url": null,
      "pdf_url": null,
      "simple_thumb_url": "https://wolnelektury.pl/media/cover_api_thumb/studnia-i-wahadlo.jpg",
      "slug": "studnia-i-wahadlo",
      "sort_key": "edgar allan poe$studnia i wahadlo$1",
      "title": "Studnia i wahad\u0142o",
      "txt_url": null,
      "url": "https://wolnelektury.pl/katalog/lektura/studnia-i-wahadlo/"
    }
  ],
  "has_more": false,
  "next_after": null,
  "result_count": 1,
  "search": "Pan Tadeusz"
}

ActionsCopy Anchor Link

Find fragmentsCopy Anchor Link

Inputs

Outputs

Get a bookCopy Anchor Link

Inputs

Outputs

Get a collectionCopy Anchor Link

Inputs

Outputs

Get a fragmentCopy Anchor Link

Inputs

Outputs

Get a tagCopy Anchor Link

Inputs

Outputs

Get book textCopy Anchor Link

Inputs

Outputs

Get download linksCopy Anchor Link

Inputs

Outputs

List booksCopy Anchor Link

Inputs

Outputs

List collectionsCopy Anchor Link

Inputs

Outputs

List tagsCopy Anchor Link

Inputs

Outputs

Search booksCopy Anchor Link

Inputs

Outputs

On this page

Actions

Find fragments

Get a book

Get a collection

Get a fragment

Get a tag

Get book text

Get download links

List books

List collections

List tags

Search books