Skip to content
All sites
Data API

Goodreads Data API

Structured JSON data, on demand, with anti-bot bypass built in.

8 endpointsaws_waf · Rate Limit handled for you
goodreads.comGET/goodreads/aut…GET/goodreads/aut…GET/goodreads/boo…{ } JSON

Goodreads Data API overview

Extract structured data from Goodreads as structured JSON. Choose an endpoint below, check its parameters, and run it in the dashboard playground.

/v1/goodreads/… Open playground

Key Features

Structured JSON

Clean, normalized records for structured data. No HTML parsing on your side.

8 endpoints

Across 5 categories, all under one base path.

Anti-bot handled

aws_waf, Rate Limit cleared for you behind the scenes.

Live data on every run

Every request scrapes the source live, so results are always current.

Regions & Languages

Global coverage. Results are returned for the default locale.

Pagination

Page through results with page, cursor.

Quick Start

Use your dedicated Data API key. Follow this endpoint's method and parameters.

data_api.py
# Install: pip install requests
import json
import os
import requests

params = json.loads("{\"query\":\"dune\"}")
response = requests.request(
    "GET", "https://api.capzy.ai/v1/goodreads/search",
    headers={"X-API-Key": os.environ["CAPZY_DATA_API_KEY"]},
    params=params,
    timeout=120,
)
response.raise_for_status()
print(response.json())

Per-run pricing

failed requests are free
EndpointCategoryPrice / 1k results
/v1/data/goodreads/authors/{author_id}AuthorAuthors1 credit / run
/v1/data/goodreads/authors/{author_id}/booksAuthor BooksAuthors1 credit / run
/v1/data/goodreads/books/{book_id}BookBooks1 credit / run
/v1/data/goodreads/books/{book_id}/reviewsBook ReviewsBooks1 credit / run
/v1/data/goodreads/lists/{list_id}List BooksLists1 credit / run
/v1/data/goodreads/listsLists by TagLists1 credit / run
/v1/data/goodreads/quotesQuotesQuotes1 credit / run
/v1/data/goodreads/searchSearch BooksSearch1 credit / run