pdfbooksworld.com APIwww.pdfbooksworld.com ↗
Search and browse public domain PDF books from pdfbooksworld.com. Get titles, authors, descriptions, cover images, and related books via 3 endpoints.
curl -X GET 'https://api.parse.bot/scraper/4171c76f-be96-4912-8428-daec733921c7/search_books' \ -H 'X-API-Key: $PARSE_API_KEY'
Search the PDF Books World library by keyword. Returns a paginated list of matching books with title, author, description snippet, and cover image URL.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keywords (e.g. 'shakespeare', 'adventure', 'science fiction'). |
| category_id | string | Category ID to filter results. Use '0' for all categories. Category IDs can be found on the site's genre/category pages (e.g. '383' for Fiction, '467' for Novels, '384' for Non Fiction, '382' for Academic & Text). |
{
"type": "object",
"fields": {
"page": "integer",
"books": "array of book objects with title, slug, author, author_url, description, image_url",
"query": "string",
"total_pages": "integer",
"has_next_page": "boolean"
},
"sample": {
"page": 1,
"books": [
{
"slug": "Shakespearean-Tragedy-by-AC-Bradley",
"title": "Shakespearean Tragedy",
"author": "Andrew Cecil Bradley",
"image_url": "https://www.pdfbooksworld.com/image/cache/new/972-150x225.jpg",
"author_url": "https://www.pdfbooksworld.com/Andrew-Cecil-Bradley",
"description": "Why Shakespeare’s Greatest Tragic Heroes Still Fascinate Readers Today..."
}
],
"query": "shakespeare",
"total_pages": 1,
"has_next_page": false
}
}About the pdfbooksworld.com API
The PDF Books World API provides access to public domain book metadata across 3 endpoints, covering search, book details, and popular listings. The search_books endpoint accepts keyword queries and optional category filters, returning paginated results with title, author, description snippets, and cover image URLs. The get_book_details endpoint exposes full synopses and related book lists for individual titles identified by their URL slug.
What the API Covers
The PDF Books World API surfaces metadata for free public domain books hosted on pdfbooksworld.com. All three endpoints return book objects containing at minimum: title, slug, author, author_url, description, and image_url. The slug field is the URL path segment used to identify a specific book (e.g. Shakespearean-Tragedy-by-AC-Bradley) and is the required input for get_book_details.
Searching and Filtering
The search_books endpoint accepts a required query string (e.g. 'adventure', 'science fiction', 'darwin') and optional page and category_id parameters. Use category_id: '0' to search across all categories. The response includes total_pages and has_next_page booleans to support iterating through paginated result sets. This makes it straightforward to collect full result sets for a given query across multiple pages.
Book Detail and Discovery
get_book_details returns a richer record for a single title, including the full description (synopsis) and a related_books array of objects with title and url. This related books list can serve as a graph traversal mechanism for discovering thematically connected titles. The list_popular_books endpoint takes no parameters and returns the site's curated list of highly-downloaded titles — useful as a seed list for catalog builds or recommendation features.
Coverage Notes
All content reflects the public domain catalog on pdfbooksworld.com. The API returns metadata only — cover images via image_url, text descriptions, and author attribution — not the PDF file content itself. Category IDs for filtering search_books results correspond to genre groupings on the source site.
- Build a public domain book search interface using
search_bookswith keyword and category filtering. - Populate a reading list application with cover images and synopses from
get_book_details. - Seed a book recommendation engine using the
related_booksfield returned per title. - Compile a ranked catalog of popular public domain titles using
list_popular_books. - Aggregate author metadata by collecting
authorandauthor_urlfields across paginated search results. - Cross-reference public domain titles against other book datasets using
slugortitleas identifiers.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does pdfbooksworld.com offer an official developer API?+
What does `get_book_details` return beyond what `search_books` provides?+
get_book_details returns the full book description (complete synopsis rather than a snippet) and a related_books array listing titles with their URLs. The search endpoint returns only a short description snippet alongside the standard book fields.Can I retrieve the actual PDF file content through this API?+
search_books, get_book_details, and list_popular_books. You can fork it on Parse and revise to add an endpoint that resolves and returns the direct PDF download URL from a book's detail page.How does pagination work in `search_books`?+
page (current page number), total_pages, and has_next_page. Pass an integer page parameter to advance through result sets. There is no offset or cursor parameter — page-number pagination only.Does the API expose category listings or a category index?+
category_id parameter in search_books, but there is no endpoint that lists all available categories and their corresponding IDs. You can fork the API on Parse and revise it to add a category listing endpoint.