audiobookbay
TypeScript icon, indicating that this package has built-in type declarations

2.0.6 • Public • Published

✨🎧AudioBookBay Scraper🎧✨

🏁 Install

npm install audiobookbay

🔍 Search Audiobooks

Name Description Default Type
Query Search Query String
Page Search Page 1 Number
Search In Text content to search { titleAuthor: true, content: true, torrent: true } Object

import { search } from "audiobookbay";

const audiobooks = await search("dune", 1, {
  titleAuthor: true,
});

Response

{
 "pagination": {
  "currentPage": "Current Page",
  "total": "Total Pages"
 },
 "data": [
   {
     "title": "Audiobook Title",
     "url":
       "Audiobook URL",
     "category":
       ["Array of Categories"],
     "lang": "Audiobook Language",
     "cover": "Audiobook Cover",
     "posted": "Date when Audiobook was posted",
     "info": {
         "format": "Audiobook Format",
         "bitrate": "Audiobook Bitrate",
         "size": ["Audiobook Size","Size UNIT"]
     }
   }, ...
 ]
}

🪣 Explore By Category/Tag

Category Options

  • Age: children, teen-young-adult, adults, the-undead
  • Category: postapocalyptic, action, adventure, art, autobiography-biographies, business, computer, contemporary, crime, detective, doctor-who-sci-fi, education, fantasy, general-fiction, historical-fiction, history, horror, lecture, lgbt, literature, litrpg, general-non-fiction, mystery, paranormal, plays-theater, poetry, political, radio-productions, romance, sci-fi, science, self-help, spiritual, sports, suspense, thriller, true-crime, tutorial, westerns
  • Category Modifiers: anthology, bestsellers, classic, documentary, full-cast, libertarian, military, novel, short-story
  • Tag Options

    • Popular Language: english, dutch, french, spanish, german
    Name Description Default Type
    Type Explore by tag, category category String
    Option Options filter String
    Page Page Number 1 String

    import { explore } from "audiobookbay";
    
    const audiobooks = await explore("category", "postapocalyptic", 2);

    Response

    {
     "pagination": {
      "currentPage": "Current Page",
      "total": "Total Pages"
     },
     "data": [
       {
         "title": "Audiobook Title",
         "url":
           "Audiobook URL",
         "category":
           ["Array of Categories"],
         "lang": "Audiobook Language",
         "cover": "Audiobook Cover",
         "posted": "Date when Audiobook was posted",
         "info": {
             "format": "Audiobook Format",
             "bitrate": "Audiobook Bitrate",
             "size": ["Audiobook Size","Size UNIT"]
         }
       }, ...
     ]
    }

    🎵 Get Audiobook

    Name Description Default Type
    ID Audiobook ID String

    import { audiobook } from "audiobookbay";
    
    const audiobook = await audiobook(
      "the-road-to-dune-brian-herbert-kevin-j-anderson-frank-herbert"
    );

    Response

    {
      "title": "Audiobook title",
      "category": ["Array of Categories"],
      "lang": "Audiobook Language",
      "cover": "Audiobook Cover",
      "author": "Audiobook Author",
      "read": "Audiobook Reader",
      "audioSample": "Sample of Audiobook MP3",
      "specs": {
        "format": "Audiobook Format",
        "bitrate": "Audiobook Bitrate"
      },
      "abridged": "Is the book shortened",
      "desc": "Audiobook Description",
      "torrent": {
        "hash": "Audiobook Hash",
        "trackers": ["Audiobook Trackers"],
        "size": ["Audiobook size", "Size UNIT"],
        "magnetUrl": "Magnet Link" // 🧲 Magnet Link
      },
      "related": [
        {
          "title": "Related Audiobook Title",
          "url": "Related Audiobook URL"
        }
      ]
    }

    ⚡ Example Usage

    Included is an example using the library.

    usage-example.ts

    To run it from this repo.

    pnpm example

    Package Sidebar

    Install

    npm i audiobookbay

    Weekly Downloads

    7

    Version

    2.0.6

    License

    ISC

    Unpacked Size

    210 kB

    Total Files

    50

    Last publish

    Collaborators

    • licavalentin