pdfdrive-api 0.1.2

Explore, search, and download ebooks programmatically or via CLI

pdfdrive-api

Unofficial Python wrapper for pdfdrive.com.co

Features

• Search ebooks with optional filters (tag, category, etc.)
• Explore books by categories or homepage
• Download ebooks asynchronously with high speed
• Full CLI support for interactive and automated usage
• Easy integration in scripts and applications

Installation

$ uv pip install "pdfdrive-api[cli]"

Developer Usage

Download by URL

from pdfdrive_api import BookDetails, Downloader

book_details = BookDetails(
    "https://pdfdrive.com.co/rich-dad-poor-dad-pdf/"
)

downloader = Downloader()

async def download_book():
    details = await book_details.get_details(for_download=True)
    download_url = details.book.download_url

    downloaded_file = await downloader.run(
        download_url,
        test=False,
        suppress_incompatible_error=True
    )

    print(downloaded_file)


if __name__ == "__main__":
    import asyncio
    asyncio.run(download_book())

---

Search and Download

from pdfdrive_api import BookDetails, Downloader, SearchPage

async def main():
    search = SearchPage("Rich dad")
    resp = await search.get_content()
    target_book = resp.books.books[0]

    book_details = await BookDetails(target_book.url).get_details(for_download=True)
    downloader = Downloader()

    downloaded_file = await downloader.run(
        book_details.download_url,
        suppress_incompatible_error=True,
        test=True
    )

    print(downloaded_file)

if __name__ == "__main__":
    import asyncio
    asyncio.run(main())

Command Line Interface (CLI)

The package installs a CLI tool called pdfdrive for quick searching, exploring, and downloading ebooks.

pdfdrive --help

Usage: pdfdrive COMMAND

Explore, search and download ebooks from pdfdrive.com.co

Commands:
  download      Download ebook by specifying its title or page URL
  explore       Explore available ebooks by different criteria
  search        Search for a particular book by its title
  --help, -h    Display this message and exit
  --version, -v Display application version

---

pdfdrive download

pdfdrive download QUERY [ARGS]

Download an ebook by title or by its page URL.

Parameter	Aliases	Description	Default
QUERY	--query	Search text or book page URL.	Required
--dir	-d	Directory to save downloaded files.	[current working directory]
--filename	-f	Custom filename for output file.	Auto-generated
--connections		Number of parallel download connections.	5
--yes, -y		Proceed with the first search result automatically.	False
--quiet, -q		Auto-download book whose title matches the query exactly.	False

Examples:

# Download a book interactively
pdfdrive download "The Pragmatic Programmer"

# Auto-download first result
pdfdrive download "Clean Code" -y

# Download by URL
pdfdrive download "https://pdfdrive.com.co/book/clean-code-pdf/"

# Custom directory and filename
pdfdrive download "Deep Learning with Python" -d ~/Downloads -f deeplearning.pdf

pdfdrive explore

pdfdrive explore [ARGS]

Explore ebooks by category, tag, search query, or directly from a listing URL.

Parameters

Parameter	Aliases	Description	Default
--offset	-o	Page number to start from.	–
--confirm, --no-confirm	-c	Ask before going to the next page.	False
--details, --no-details	-d	Display detailed book info.	False
--limit	-l	Number of pages to explore.	10
--infinity	-i	Explore indefinitely without page limit.	False
--search	-s	Explore by a text query.	–
--category	-c	Explore a category.	Choices include: astrology, biography, academic-and-education, business-and-career, health, novels, self-improvement, religion, etc.
--name	-n	Explore books with a particular tag.	–
--url	-u	Explore books from a specific listing URL.	–
--homepage, -home		Explore homepage content.	True

Examples:

# Explore homepage
pdfdrive explore

# Explore 5 pages in 'business-and-career' category
pdfdrive explore -c business-and-career -l 5

# Explore books tagged "machine learning"
pdfdrive explore -t "machine learning"

# Explore using URL
pdfdrive explore --u "https://pdfdrive.com.co/category/academic-and-education"

# Infinite exploration, auto-advance
pdfdrive explore -i

pdfdrive search

pdfdrive search QUERY [ARGS]

Search for a book by title. Optionally select, auto-proceed, or download directly.

Parameter	Aliases	Description	Default
QUERY	--query	Search text.	Required
--limit	-l	Number of result pages to scan.	1
--yes, -y		Automatically select the first book found.	False
--select-one	-s	Prompt user to select a book from results.	Manual
--quiet	-q	Automatically proceed if exact title match is found.	–

Examples:

# Search for a book interactively
pdfdrive search "Rich Dad Poor Dad"

# Auto-select first search result
pdfdrive search "Clean Architecture" -y

# Prompt to choose a book
pdfdrive search "Deep Learning" -s

# Quiet mode – exact title match
pdfdrive search "Atomic Habits" -q

# Search across 3 pages
pdfdrive search "Artificial Intelligence" -l 3

Summary

Command	Description
pdfdrive download	Download an ebook by title or URL
pdfdrive explore	Explore ebooks by category, tag, or query
pdfdrive search	Search for a particular book by title