Performs a book search. Try it now.
Request
HTTP Request
GET https://www.googleapis.com/books/v1/volumes?q={search terms}
Parameters
Parameter Name | Value | Description |
---|---|---|
Required Parameters | ||
q |
string |
Full-text search query string. |
Optional Parameters | ||
download |
string |
Restrict to volumes by download availability.
Acceptable values are:
|
filter |
string |
Filter search results.
Acceptable values are:
|
langRestrict |
string |
Restrict results to books with this language code. |
libraryRestrict |
string |
Restrict search to this user's library.
Acceptable values are:
|
maxResults |
unsigned integer |
Maximum number of results to return.
Acceptable values are 0 to 40 , inclusive.
|
orderBy |
string |
Sort search results.
Acceptable values are:
|
partner |
string |
Restrict and brand results for partner ID. |
printType |
string |
Restrict to books or magazines.
Acceptable values are:
|
projection |
string |
Restrict information returned to a set of selected fields.
Acceptable values are:
|
showPreorders |
boolean |
Set to true to show books available for preorder. Defaults to false. |
source |
string |
String to identify the originator of this request. |
startIndex |
unsigned integer |
Index of the first result to return (starts at 0) |
Request Body
Do not supply a request body with this method.
Response
If successful, this method returns a response body with the following structure:
{
"kind": "books#volumes",
"items": [
volume Resource
],
"totalItems":(value)
}
Property Name | Value | Description | Notes |
---|---|---|---|
kind |
string |
Resource type. | |
items[] |
list |
A list of volumes. | |
totalItems |
integer |
Total number of volumes found. This might be greater than the number of volumes returned in this response if results have been paginated. |
Try It!
Use the explorer below to call this method on live data and see the response.