Books API
googleapis · Analytics
The Google Books API allows clients to access the Google Books repository.
Authentication
Sample Requests
Performs a book search.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/volumes?q=test&alt=json&key=YOUR_API_KEY&fields=example&filter=FILTER_UNDEFINED&source=example&$.xgafv=1&orderBy=ORDER_BY_UNDEFINED&partner=example&callback=example&download=DOWNLOAD_UNDEFINED&printType=PRINT_TYPE_UNDEFINED"aUser=example&maxResults=1&projection=PROJECTION_UNDEFINED&startIndex=1&uploadType=example&oauth_token=example&prettyPrint=true&access_token=example&langRestrict=example&showPreorders=true&libraryRestrict=LIBRARY_RESTRICT_UNDEFINED&upload_protocol=example&maxAllowedMaturityRating=MAX_ALLOWED_MATURITY_RATING_UNDEFINED"
import requests
params = {
"q": "test",
"alt": "json",
"key": "YOUR_API_KEY",
"fields": "example",
"filter": "FILTER_UNDEFINED",
"source": "example",
"$.xgafv": "1",
"orderBy": "ORDER_BY_UNDEFINED",
"partner": "example",
"callback": "example",
"download": "DOWNLOAD_UNDEFINED",
"printType": "PRINT_TYPE_UNDEFINED",
"quotaUser": "example",
"maxResults": "1",
"projection": "PROJECTION_UNDEFINED",
"startIndex": "1",
"uploadType": "example",
"oauth_token": "example",
"prettyPrint": "true",
"access_token": "example",
"langRestrict": "example",
"showPreorders": "true",
"libraryRestrict": "LIBRARY_RESTRICT_UNDEFINED",
"upload_protocol": "example",
"maxAllowedMaturityRating": "MAX_ALLOWED_MATURITY_RATING_UNDEFINED"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/volumes",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/volumes');
url.searchParams.set('q', 'test');
url.searchParams.set('alt', 'json');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('filter', 'FILTER_UNDEFINED');
url.searchParams.set('source', 'example');
url.searchParams.set('$.xgafv', '1');
url.searchParams.set('orderBy', 'ORDER_BY_UNDEFINED');
url.searchParams.set('partner', 'example');
url.searchParams.set('callback', 'example');
url.searchParams.set('download', 'DOWNLOAD_UNDEFINED');
url.searchParams.set('printType', 'PRINT_TYPE_UNDEFINED');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('maxResults', '1');
url.searchParams.set('projection', 'PROJECTION_UNDEFINED');
url.searchParams.set('startIndex', '1');
url.searchParams.set('uploadType', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('access_token', 'example');
url.searchParams.set('langRestrict', 'example');
url.searchParams.set('showPreorders', 'true');
url.searchParams.set('libraryRestrict', 'LIBRARY_RESTRICT_UNDEFINED');
url.searchParams.set('upload_protocol', 'example');
url.searchParams.set('maxAllowedMaturityRating', 'MAX_ALLOWED_MATURITY_RATING_UNDEFINED');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/volumes")
q := baseURL.Query()
q.Set("q", "test")
q.Set("alt", "json")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("filter", "FILTER_UNDEFINED")
q.Set("source", "example")
q.Set("$.xgafv", "1")
q.Set("orderBy", "ORDER_BY_UNDEFINED")
q.Set("partner", "example")
q.Set("callback", "example")
q.Set("download", "DOWNLOAD_UNDEFINED")
q.Set("printType", "PRINT_TYPE_UNDEFINED")
q.Set("quotaUser", "example")
q.Set("maxResults", "1")
q.Set("projection", "PROJECTION_UNDEFINED")
q.Set("startIndex", "1")
q.Set("uploadType", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("access_token", "example")
q.Set("langRestrict", "example")
q.Set("showPreorders", "true")
q.Set("libraryRestrict", "LIBRARY_RESTRICT_UNDEFINED")
q.Set("upload_protocol", "example")
q.Set("maxAllowedMaturityRating", "MAX_ALLOWED_MATURITY_RATING_UNDEFINED")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/volumes")
uri.query = URI.encode_www_form({
"q" => "test",
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"filter" => "FILTER_UNDEFINED",
"source" => "example",
"$.xgafv" => "1",
"orderBy" => "ORDER_BY_UNDEFINED",
"partner" => "example",
"callback" => "example",
"download" => "DOWNLOAD_UNDEFINED",
"printType" => "PRINT_TYPE_UNDEFINED",
"quotaUser" => "example",
"maxResults" => "1",
"projection" => "PROJECTION_UNDEFINED",
"startIndex" => "1",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"langRestrict" => "example",
"showPreorders" => "true",
"libraryRestrict" => "LIBRARY_RESTRICT_UNDEFINED",
"upload_protocol" => "example",
"maxAllowedMaturityRating" => "MAX_ALLOWED_MATURITY_RATING_UNDEFINED"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/volumes?" . http_build_query([
"q" => "test",
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"filter" => "FILTER_UNDEFINED",
"source" => "example",
"$.xgafv" => "1",
"orderBy" => "ORDER_BY_UNDEFINED",
"partner" => "example",
"callback" => "example",
"download" => "DOWNLOAD_UNDEFINED",
"printType" => "PRINT_TYPE_UNDEFINED",
"quotaUser" => "example",
"maxResults" => "1",
"projection" => "PROJECTION_UNDEFINED",
"startIndex" => "1",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"langRestrict" => "example",
"showPreorders" => "true",
"libraryRestrict" => "LIBRARY_RESTRICT_UNDEFINED",
"upload_protocol" => "example",
"maxAllowedMaturityRating" => "MAX_ALLOWED_MATURITY_RATING_UNDEFINED"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Returns a list of offline dictionary metadata available
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/dictionary/listOfflineMetadata?alt=json&key=YOUR_API_KEY&fields=example&$.xgafv=1&cpksver=example&callback=example"aUser=example&uploadType=example&oauth_token=example&prettyPrint=true&access_token=example&upload_protocol=example"
import requests
params = {
"alt": "json",
"key": "YOUR_API_KEY",
"fields": "example",
"$.xgafv": "1",
"cpksver": "example",
"callback": "example",
"quotaUser": "example",
"uploadType": "example",
"oauth_token": "example",
"prettyPrint": "true",
"access_token": "example",
"upload_protocol": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/dictionary/listOfflineMetadata",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/dictionary/listOfflineMetadata');
url.searchParams.set('alt', 'json');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('$.xgafv', '1');
url.searchParams.set('cpksver', 'example');
url.searchParams.set('callback', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('uploadType', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('access_token', 'example');
url.searchParams.set('upload_protocol', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/dictionary/listOfflineMetadata")
q := baseURL.Query()
q.Set("alt", "json")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("$.xgafv", "1")
q.Set("cpksver", "example")
q.Set("callback", "example")
q.Set("quotaUser", "example")
q.Set("uploadType", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("access_token", "example")
q.Set("upload_protocol", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/dictionary/listOfflineMetadata")
uri.query = URI.encode_www_form({
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"$.xgafv" => "1",
"cpksver" => "example",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/dictionary/listOfflineMetadata?" . http_build_query([
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"$.xgafv" => "1",
"cpksver" => "example",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Gets information regarding the family that the user is part of.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/familysharing/getFamilyInfo?alt=json&key=YOUR_API_KEY&fields=example&source=example&$.xgafv=1&callback=example"aUser=example&uploadType=example&oauth_token=example&prettyPrint=true&access_token=example&upload_protocol=example"
import requests
params = {
"alt": "json",
"key": "YOUR_API_KEY",
"fields": "example",
"source": "example",
"$.xgafv": "1",
"callback": "example",
"quotaUser": "example",
"uploadType": "example",
"oauth_token": "example",
"prettyPrint": "true",
"access_token": "example",
"upload_protocol": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/familysharing/getFamilyInfo",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/familysharing/getFamilyInfo');
url.searchParams.set('alt', 'json');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('fields', 'example');
url.searchParams.set('source', 'example');
url.searchParams.set('$.xgafv', '1');
url.searchParams.set('callback', 'example');
url.searchParams.set('quotaUser', 'example');
url.searchParams.set('uploadType', 'example');
url.searchParams.set('oauth_token', 'example');
url.searchParams.set('prettyPrint', 'true');
url.searchParams.set('access_token', 'example');
url.searchParams.set('upload_protocol', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/familysharing/getFamilyInfo")
q := baseURL.Query()
q.Set("alt", "json")
q.Set("key", "YOUR_API_KEY")
q.Set("fields", "example")
q.Set("source", "example")
q.Set("$.xgafv", "1")
q.Set("callback", "example")
q.Set("quotaUser", "example")
q.Set("uploadType", "example")
q.Set("oauth_token", "example")
q.Set("prettyPrint", "true")
q.Set("access_token", "example")
q.Set("upload_protocol", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/familysharing/getFamilyInfo")
uri.query = URI.encode_www_form({
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"source" => "example",
"$.xgafv" => "1",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/googleapis.com/books/v1/books/v1/familysharing/getFamilyInfo?" . http_build_query([
"alt" => "json",
"key" => "YOUR_API_KEY",
"fields" => "example",
"source" => "example",
"$.xgafv" => "1",
"callback" => "example",
"quotaUser" => "example",
"uploadType" => "example",
"oauth_token" => "example",
"prettyPrint" => "true",
"access_token" => "example",
"upload_protocol" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Books API?
Books API is a Analytics API. Developers commonly use analytics APIs for:
- tracking product usage and user behaviour
- building custom reporting and BI dashboards
- measuring marketing and campaign performance
- running funnel, retention, and cohort analysis
- aggregating metrics from multiple data sources
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Books API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide