Open Library Search — Books by Title, Author or Subject
Pricing
from $0.50 / 1,000 results
Open Library Search — Books by Title, Author or Subject
Search the Internet Archive's Open Library and get flat book rows — title, first author, first publish year, editions and ISBN.
Pricing
from $0.50 / 1,000 results
Rating
0.0
(0)
Developer
alaudin burki
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
20 days ago
Last modified
Categories
Features
Share
Open Library is the Internet Archive's catalogue of books, with one record per work and separate records for its editions. This Actor searches the catalogue and writes one flat row per work: title, first author, first publication year, a language code, the number of editions held and one ISBN. It reads the public search endpoint directly, so no key or account is required.
Results come back 100 works per page. The Actor pages through them, waits 200 ms between requests, and stops when the catalogue runs out, when maxPages is reached or when maxItems rows have been written.
How to use
- Enter a Query — a book title, an author name or a subject.
- Set Max rows and Max requests to bound the run.
- Run the Actor and export the dataset as JSON, CSV or Excel.
Inputs
| Field | Purpose | Default |
|---|---|---|
query | What to search for: a title, an author or a subject. Sent as the catalogue's q parameter, so plain words work, and Open Library's own field prefixes are accepted too. | — |
maxItems | Hard cap on rows written to the dataset. | 500 |
maxPages | Maximum requests. Each request returns up to 100 works. | 5 |
maxItems is clamped to 20,000 and maxPages to 200 per run. With the defaults, a run reads up to five pages of 100 works and stops at 500 rows, whichever comes first. A query that matches nothing returns an empty dataset with a successful run.
Output dataset
| Field | Meaning |
|---|---|
title | The work's title as the catalogue writes it. |
author | The first author name listed for the work. Further authors are not returned. |
firstPublishYear | The year of the earliest edition of this work that Open Library holds. It is not the year of any particular edition you may own. |
language | The first language code listed for the work, in the catalogue's own form, e.g. eng. Additional languages are not returned. |
editionCount | How many editions of the work the catalogue holds. A count of editions, not of copies or libraries. |
isbn | One ISBN taken from the work's edition list, usually the first. Hyphens are the source's, and it may be ISBN-10 or ISBN-13. |
url | The work's page on Open Library, built from its work key. |
Every row also carries id (the work key prefixed with ol:, e.g. ol:/works/OL12345W), source (openlibrary-search), firstSeenAt and scrapedAt. Rows are de-duplicated on the work key and sorted by id. A SUMMARY record in the run's key-value store reports rows, requests, duplicates, page problems and whether a cap truncated the dataset.
Example input
{"query": "dune frank herbert","maxItems": 500,"maxPages": 5}
Why this is different
- Open Library Search returns one row per work, not per edition, so a book is not repeated once for every printing.
- Open Library Search needs no key, account or registration before its first run.
- Open Library Search reports the earliest publication year the catalogue holds, which is usually what a "when was this written" question needs.
- Open Library Search builds the work's Open Library URL from its key, so every row can be checked against the source.
- Open Library Search stops on a short page, which means the catalogue is exhausted, and distinguishes that from a cap.
- Open Library Search de-duplicates on the work key and sorts by it, so repeat runs over unchanged data agree.
Limitations
- One author per row. A book with three authors returns only the first, so author searches should be run per name rather than relying on the row to name everyone.
- One ISBN per row, taken from the work's edition list. It identifies one edition, not the work, and it can be missing entirely.
languageis a single code from the catalogue and uses its conventions, not a fixed two-letter list. It is left out of the row when the catalogue has not tagged the work.firstPublishYearis the earliest edition Open Library holds. A work first published long before the library catalogued it shows the earliest year it has, which may be later than the true first publication.- Coverage is Open Library's. A book the catalogue has not indexed cannot be found, and the counts here are not a claim about the book's real edition history.
- The search matches the catalogue's index, not full text. A phrase that appears only inside a book is not a reason for it to be returned.
- Records are assembled from library and community contributions, so a title, author spelling or year can be wrong at the source. The Actor passes values through and does not correct them.
FAQ
Do I need an Open Library or Internet Archive account?
No. The search endpoint is public and the Actor sends no key.
Can I search by ISBN?
The query input is a text search, not an identifier lookup. An ISBN in the query may match, but the row's isbn field is one edition's number rather than a guaranteed lookup result.
Why does a book show an older or newer year than I expected?
firstPublishYear is the earliest edition the catalogue holds, not the first edition ever printed. A gap in the catalogue shifts the year.
Why is the author field missing?
The catalogue does not always link a work to an author record. The Actor returns what is there and leaves the field out rather than filling in a guess.
Why did the run stop before Max rows?
Either the query ran out of matches, or maxPages was reached first. The SUMMARY record names the stop reason; raise maxPages to read further.
Pricing and limits
The price is shown on this Actor's Apify pricing panel, and charges follow the pricing model displayed there. The caps in this README describe how much data the Actor requests; they are not a price. Each request returns up to 100 works, requests are paced 200 ms apart, and a run stops at maxItems rows or maxPages requests, or when the catalogue returns a short page.