volumes: Search for books

API: googleapis.com:google-books-api
Endpoint: /volumes
Response format: application/json
Auth: api_key
Method: GET
Last Status: 429
Latency: 674ms

Description

Performs a book search using query terms. Supports full-text search across book content, metadata search by title, author, ISBN, and other fields.

Parameters (9)

download (string, query, optional)

Restrict to books available for download format

Constraints: {'enum': ['epub']}

filter (string, query, optional)

Filter search results by availability

Constraints: {'enum': ['partial', 'full', 'free-ebooks', 'paid-ebooks', 'ebooks']}

langRestrict (string, query, optional)

Restrict results to books in specified language (ISO 639-1 code)

maxResults (integer, query, optional, default: 10)

Maximum number of results to return (1-40)

Constraints: {'minimum': 1, 'maximum': 40}

orderBy (string, query, optional, default: relevance)

Sort order for results

Constraints: {'enum': ['relevance', 'newest']}

printType (string, query, optional, default: all)

Restrict results to a specific print type

Constraints: {'enum': ['all', 'books', 'magazines']}

projection (string, query, optional, default: full)

Level of detail in response

Constraints: {'enum': ['full', 'lite']}

q (string, query, required)

Search query. Can use special keywords: intitle:, inauthor:, inpublisher:, subject:, isbn:, lccn:, oclc:

startIndex (integer, query, optional, default: 0)

Index of the first result to return (0-based)

Constraints: {'minimum': 0}

Examples (2)

Search for books openapi-spec
curl 'https://www.googleapis.com/books/v1/volumes?q=intitle%3AHarry+Potter&langRestrict=en'
import requests

resp = requests.get(
    "https://www.googleapis.com/books/v1/volumes",
    params={
        'q': 'intitle:Harry Potter',
        'langRestrict': 'en',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("google-books")
result = api.fetch("volumes", q="intitle:Harry Potter", langRestrict="en")

for item in result:
    print(item)
const resp = await fetch("https://www.googleapis.com/books/v1/volumes?q=intitle%3AHarry+Potter&langRestrict=en");
const data = await resp.json();
Search for books probe-gate
curl 'https://www.googleapis.com/books/v1/volumes?q=intitle%3AHarry+Potter&startIndex=0&maxResults=10&printType=all&projection=full&orderBy=relevance&langRestrict=en'
import requests

resp = requests.get(
    "https://www.googleapis.com/books/v1/volumes",
    params={
        'q': 'intitle:Harry Potter',
        'startIndex': '0',
        'maxResults': '10',
        'printType': 'all',
        'projection': 'full',
        'orderBy': 'relevance',
        'langRestrict': 'en',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("google-books")
result = api.fetch("volumes", q="intitle:Harry Potter", startIndex=0, maxResults=10, printType="all", projection="full", orderBy="relevance", langRestrict="en")

for item in result:
    print(item)
const resp = await fetch("https://www.googleapis.com/books/v1/volumes?q=intitle%3AHarry+Potter&startIndex=0&maxResults=10&printType=all&projection=full&orderBy=relevance&langRestrict=en");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 00:49:34.941098 429 674ms
2026-04-16 00:10:11.547464 429 701ms
2026-04-15 03:51:23.238840 429 787ms
2026-04-15 01:40:37.051263 429 1003ms
2026-04-14 00:41:21.281891 429 905ms
2026-04-14 00:03:55.985929 429 955ms
2026-04-12 15:43:26.878683 200 774ms
2026-04-12 15:14:49.138730 503 300ms
2026-04-10 02:43:14.905663 429 196ms
2026-04-10 00:37:50.153301 429 663ms
2026-04-09 03:28:35.150971 429 236ms
2026-04-09 02:04:40.003297 429 206ms
2026-04-03T15:22:40.651762 200 534ms