Skip to content
Gridlode
Docs · Reference

Google Books

GET /v1/search/google/books1 credit / requestcache 1440 min

Search Google Books through Google's official Books API: volume id, title, subtitle, authors, publisher, published date, description, text snippet, ISBN-10 and ISBN-13, page count, categories, average rating and rating count, language, cover thumbnails, preview, info and canonical links, sale info (saleability, list and retail price, buy link) and access info (viewability, public domain, ePub/PDF availability, web reader link). Search free text or by title, author, publisher, subject or ISBN; filter by language, books or magazines, previewable or free eBooks; sort by relevance or newest; up to 40 results per page and the first 1,000 results in total. Google limits how many API calls can be made per day; when that quota is used up the request fails with a clear, retryable error and is never charged, and so are empty pages.

Query parameters

q
string
Free-text search. Books API operators work inside it: intitle:, inauthor:, inpublisher:, subject:, isbn:, lccn:, oclc:.
Default: null
intitle
string
Words or a phrase in the title.
Default: null
inauthor
string
Author name.
Default: null
inpublisher
string
Publisher name.
Default: null
subject
string
Category/subject, e.g. Fiction.
Default: null
isbn
string
ISBN-10 or ISBN-13 (dashes are ignored).
Default: null
lang
string
Only books in this language (ISO 639-1 code, e.g. en, fr).
Default: null
print_type
string
Books, magazines or both.
Default: "all"
Allowed: all, books, magazines
order
string
relevance or newest first.
Default: "relevance"
Allowed: relevance, newest
filter
string
Only volumes with a preview (partial), fully viewable (full), free or paid Google eBooks, or any eBook.
Default: null
country
string
Country for availability and prices (2-letter code). Google needs one when it cannot place the server.
Default: "US"
page
integer
Results page.
Default: 1
num
integer
Results per page, 1-40.
Default: 10
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/search/google/books?intitle=dune&inauthor=frank%20herbert" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the Google Books API page.