v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-135137125.7 KB
volumes

Performs a book search.

get/books/v1/volumes

Query parameters

qstring required

Full-text search query string.

download'DOWNLOAD_UNDEFINED' | 'EPUB'

Restrict to volumes by download availability.

filter'FILTER_UNDEFINED' | 'ebooks' | 'free-ebooks' | 'full' | 'paid-ebooks' | 'partial'

Filter search results.

langRestrictstring

Restrict results to books with this language code.

libraryRestrict'LIBRARY_RESTRICT_UNDEFINED' | 'my-library' | 'no-restrict'

Restrict search to this user's library.

maxAllowedMaturityRating'MAX_ALLOWED_MATURITY_RATING_UNDEFINED' | 'MATURE' | 'not-mature'

The maximum allowed maturity rating of returned recommendations. Books with a higher maturity rating are filtered out.

maxResultsinteger

Maximum number of results to return.

orderBy'ORDER_BY_UNDEFINED' | 'newest' | 'relevance'

Sort search results.

partnerstring

Restrict and brand results for partner ID.

printType'PRINT_TYPE_UNDEFINED' | 'ALL' | 'BOOKS' | 'MAGAZINES'

Restrict to books or magazines.

projection'PROJECTION_UNDEFINED' | 'FULL' | 'LITE'

Restrict information returned to a set of selected fields.

showPreordersboolean

Set to true to show books available for preorder. Defaults to false.

sourcestring

String to identify the originator of this request.

startIndexinteger

Index of the first result to return (starts at 0)

Response

Successful response