---
title: "Goodreads API: JSON data, 4 endpoints, 1 credit per call"
description: "Get Goodreads data as structured JSON with one API key: search, author, book and reviews. Free credits every month."
url: https://perceptlayer.com/apis/goodreads
---

[APIs](https://perceptlayer.com/apis) / [Reviews](https://perceptlayer.com/verticals/reviews) / Goodreads

1 credit per call 4 endpoints

# Goodreads API

Get Goodreads data as structured JSON with one API key: search, author, book and reviews. Free credits every month.

[Get a free API key](https://perceptlayer.com/signup) Run it below

Goodreads

GET /v1/goodreads/search?query=the+lord+of+the+rings&page=1 

```
curl "https://api.perceptlayer.com/v1/goodreads/search?query=the+lord+of+the+rings&page=1" \
  -H "X-API-Key: $API_KEY"
```

cURL 1 credit per successful call

Run this call below or from your dashboard to see a live response.

Playground

## Run this API

cURL shell 

```
curl "https://api.perceptlayer.com/v1/goodreads/search?query=the+lord+of+the+rings&page=1" \
  -H "X-API-Key: $API_KEY"
```

Goodreads · 4 endpoints

## Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

| Endpoint | Required parameters | Cost |
| --- | --- | --- |
| [GET `/v1/goodreads/author`](https://perceptlayer.com/apis/goodreads/author) | `id` | 1 credit |
| [GET `/v1/goodreads/book`](https://perceptlayer.com/apis/goodreads/book) | `id` | 1 credit |
| [GET `/v1/goodreads/reviews`](https://perceptlayer.com/apis/goodreads/reviews) | `id` +2 optional | 1 credit |
| [GET `/v1/goodreads/search`](https://perceptlayer.com/apis/goodreads/search) | `query` +1 optional | 1 credit |

Overview

## About the Goodreads API

## What you can get

The Goodreads API returns search, author, book and reviews as clean JSON. Each successful call costs one credit, and calls that fail are free.

Reviews JSON REST MCP

### More reviews APIs

[Capterra](https://perceptlayer.com/apis/capterra) [Jameda](https://perceptlayer.com/apis/jameda) [Letterboxd](https://perceptlayer.com/apis/letterboxd) [MyAnimeList](https://perceptlayer.com/apis/myanimelist) [Tripadvisor](https://perceptlayer.com/apis/tripadvisor) [Trusted Shops](https://perceptlayer.com/apis/trusted-shops) [Trustpilot](https://perceptlayer.com/apis/trustpilot) [Yelp](https://perceptlayer.com/apis/yelp)

Use cases

### Pull book details, ratings and reviews

`Use the Goodreads API to pull book details, ratings and reviews` 

### Research authors and their books

`Use the Goodreads API to research authors and their books` 

### Analyse reader sentiment for a title

`Use the Goodreads API to analyse reader sentiment for a title` 

FAQ

## Questions

**How much does the Goodreads API cost?**

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

**What format are responses in?**

Every endpoint returns JSON, with no HTML parsing on your side.

**Do I need a separate key for Goodreads?**

No. One key works for every API in the catalogue.

## Try the Goodreads API with 1,000 free credits

No credit card. Failed calls are never billed.

[Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)