Open Library Books - Search and ISBN Metadata avatar

Open Library Books - Search and ISBN Metadata

Pricing

$1.20 / 1,000 book results

Go to Apify Store
Open Library Books - Search and ISBN Metadata

Open Library Books - Search and ISBN Metadata

Search Open Library by title, author or keywords, or look up one ISBN edition. Saves authors, ISBNs, subjects, years and links. Official API, no key.

Pricing

$1.20 / 1,000 book results

Rating

0.0

(0)

Developer

Atesen Software

Atesen Software

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

3 days ago

Last modified

Categories

Features

Limited permissions

Share

Open Library Books — Search and ISBN Metadata

Need clean book metadata (title, authors, ISBNs, subjects, first publish year) without copying it by hand from Open Library? This Actor searches Open Library by keywords, title or author, or resolves one ISBN to its exact edition, and saves tidy rows you can export as JSON, CSV or Excel — for $1.20 per 1,000 books.

Data source: Open Library, a project of the Internet Archive, through its official public Search API and Books API. No API key, login or proxy is needed. Built and maintained by Atesen Software.

What you can use it for

  • Catalog and reading-list enrichment: add authors, subjects, publication years, languages and Open Library links to your own book list.
  • ISBN resolution: turn a checksum-valid ISBN-10 or ISBN-13 into the exact edition record.
  • Library, classroom and research lookups: confirm a title exists, compare edition counts and first publication years.
  • Prototype data for book apps: small, capped exports instead of hand-built spreadsheets.

Input

{"title":"The Hobbit","maxBooks":2,"includeCoverUrl":true}
  • query, title and author can be combined (for example {"title":"Dune","author":"Herbert"}).
  • isbn is a separate mode for one edition: {"isbn":"978-0-261-10221-7"}. Spaces and hyphens are accepted; the checksum is validated before any request.
  • maxBooks: 1–50, default 10. maxRequests: 1–10, default 10 (retries count).
  • includeCoverUrl: default false. Adds a cover image URL only; images are never downloaded.

Missing selectors or an invalid ISBN do not fail the run: you get one free status row explaining the problem, with zero API requests and zero charge.

Output

Each book row has title, authors, authorIds, workId / editionId, metadataLevel (work for search results, edition for ISBN lookups), firstPublishYear, publicationYears or publicationDate, editionCount, isbns, subjects, languages, editionIds, openLibraryUrl, optional coverUrl, the sourceUrl of the API call and retrievedAt. Fields missing at the source stay null or empty; nothing is invented. Lists are capped at 100 entries.

Example row from a real run with {"title":"The Hobbit"} (lists shortened):

{
"recordType": "book",
"status": "completed",
"metadataLevel": "work",
"workId": "OL27482W",
"editionId": null,
"title": "The Hobbit",
"authors": ["J.R.R. Tolkien"],
"authorIds": ["OL26320A"],
"firstPublishYear": 1937,
"editionCount": 482,
"isbns": ["9788422615866", "9780739410745", "0261102214"],
"subjects": ["Fantasy", "Battle of Five Armies", "dragons"],
"openLibraryUrl": "https://openlibrary.org/works/OL27482W",
"coverUrl": null
}

An ISBN lookup ({"isbn":"978-0-261-10221-7"}) returned edition OL37509862M, publicationDate "2009" and ISBNs 9780261102217 and 0261102214.

Every run also writes one free status row and an OUTPUT summary (status, saved rows, request count) in the key-value store.

How much does it cost?

Pay per event: $0.0012 per saved book ($1.20 per 1,000 books). There is no start fee. Status rows, invalid input, no-match searches and provider errors are never charged. You can set a maximum cost per run; the budget is checked before every API request and every row, so the Actor stops cleanly when it is reached.

Run outcomes

  • completed / no_results: normal finish.
  • invalid_input: free status row, no requests.
  • rate_limited: Open Library asked to slow down for longer than 15 seconds; the run finishes with a free status row and a retryAt time. Books already saved stay in the dataset.
  • request_limit / budget_limit: the request cap or your cost limit was reached; saved books stay.
  • Unexpected HTTP errors, redirects or invalid JSON from the API fail the run loudly so you never mistake an outage for "no books".

Fair use of Open Library

Open Library asks API users to identify their application, stay within its rate limits and use the monthly data dumps for bulk work (API guidelines). This Actor sends an honest User-Agent with the app name and a support contact, waits at least 1.1 seconds between requests, honors Retry-After on 429/503, never follows redirects, and caps each run at 50 books and 10 requests. It only calls the JSON APIs; it does not scrape HTML, crawl the Covers API or download texts, scans or images. Please keep runs small and spaced, and do not use it as a high-traffic backend; for a full catalog, download the dumps.

Data licensing and attribution

Open Library states that it does not assert any new copyright over the material in its database, and that some contributions may carry existing rights in some jurisdictions (licensing). Cover images are provided separately by the Covers API; if you display covers, Open Library asks for a courtesy link back. Please credit Open Library when you publish the data.

FAQ

Why are runs capped at 50 books? The cap keeps usage at the human scale the provider's guidelines ask for. For bulk data, use the Open Library dumps.

Work or edition? Search results are works (one book across many editions). ISBN lookups return one edition. Check metadataLevel before comparing editionCount or firstPublishYear.

Can I get full texts or cover files? No. Only metadata and, optionally, the cover URL.

Can I schedule it? Yes, for small, spaced runs.

Is personal data involved? No. Titles, ISBNs and author names are bibliographic data.

Support

Use the Issues tab on the Actor page or write to support@atesensoftware.com. This Actor is independent and not affiliated with Open Library or the Internet Archive. Built and maintained by Atesen Software.