Recipe Entertainment, books and games

Goodreads scraper API: search results as JSON

Send any Goodreads page URL with recipe=goodreads and get title, url, image as JSON. No selectors to write, no proxies to pick.

1 page type
3 fields
5 credits a page · $0.50 per 1,000
Working · 100% in 7 days

Get a free API key Try it in the Playground

5,000 free credits for 7 days, no card.

recipe=goodreads

curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://www.goodreads.com/search?q=project+hail+mary' \
  --data-urlencode 'recipe=goodreads'

200 OK · JSON

{
    "result": {
        "title": "Project Hail Mary"
    },
    "success": true
}

What you get from Goodreads

The fields of each page type and a real sample from our last validation, shortened.

Search and listing pages `recipe=goodreads` 5 credits a page

Field	Type	Example
`results`	list of 3+ items
`results[].url`	URL	https://www.goodreads.com/book/show/54493401?ref=s_s
`results[].title`	text	Project Hail Mary
`results[].image`	image URL	https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/...

Sample answer, validated 2026-11-01

{
    "results": [
        {
            "url": "https://www.goodreads.com/book/show/54493401?ref=s_s",
            "title": "Project Hail Mary",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1764703833i/54493401.jpg"
        },
        {
            "url": "https://www.goodreads.com/book/show/119255205?ref=s_s",
            "title": "Project Hail Mary / Artemis/ The Martian",
            "image": "https://m.media-amazon.com/images/S/compressed.photo.goodreads.com/books/1676421869i/119255205.jpg"
        }
    ]
}

One call

Send the page URL and the recipe name to the Scrape API. The recipe brings the extract rules and the settings that work on Goodreads (JavaScript rendering and a wait for the content).

curl -G 'https://api.ujeebu.com/scrape' \
  -H "ApiKey: $UJEEBU_API_KEY" \
  --data-urlencode 'url=https://www.goodreads.com/search?q=project+hail+mary' \
  --data-urlencode 'recipe=goodreads'

import os, requests

r = requests.get(
    "https://api.ujeebu.com/scrape",
    params={"url": "https://www.goodreads.com/search?q=project+hail+mary", "recipe": "goodreads"},
    headers={"ApiKey": os.environ["UJEEBU_API_KEY"]},
    timeout=120,
)
print(r.json()["result"])

const params = new URLSearchParams({
  url: "https://www.goodreads.com/search?q=project+hail+mary",
  recipe: "goodreads",
});
const res = await fetch(`https://api.ujeebu.com/scrape?${params}`, {
  headers: { ApiKey: process.env.UJEEBU_API_KEY },
});
console.log((await res.json()).result);

The answer is {"result": {...}} with the headers Ujb-Recipe and Ujb-Credits. Your own parameters always win over the recipe.

Search Goodreads with parameters

Fill in the parameters and we build the Goodreads search URL. The Playground and the Request builder do it for you.

Parameter	Type	Values
`query` required	string	Title, author or ISBN.
`page`	int	1 to 10

Works today: the built URL with recipe=goodreads/listing (query=project hail mary)

GET https://api.ujeebu.com/scrape?url=https%3A%2F%2Fwww.goodreads.com%2Fsearch%3Fq%3Dproject%2520hail%2520mary&recipe=goodreads%2Flisting

A single call with the parameters and no URL is coming to the API; it is not live yet. Search with parameters in the docs

What people build with Goodreads data

Research datasets
Build datasets of public pages for analysis, search or LLM pipelines.
Learn more

Price

Same price as the page call, no fee for the recipe. Only successful responses are billed; blocked, timed-out and failed requests are free.

Page type	Credits a page	Per 1,000, Starter	Per 1,000, Pro
Search results	5	$0.82	$0.50

See all plans

FAQ

What does the Goodreads recipe return?

JSON with 3 fields from search results (recipe=goodreads), for example title, url, image. The answer is {"result": {...}} with the fields shown on this page.

How much does it cost to scrape Goodreads?

5 credits a page ($0.50 per 1,000 on Pro, $0.82 on Starter). Same price as the page call, no fee for the recipe. Only successful responses are billed; blocked, timed-out and failed requests are free.

Do I need proxies or a headless browser?

No. The recipe brings the settings that work on Goodreads: JavaScript rendering and a wait for the content. Send only the URL and recipe=goodreads.

What happens when Goodreads changes its pages?

We check Goodreads every day and re-validate the recipe on real pages every week, then fix it when the site changes. Until a fix is live, the API answers 404 "the recipe has no working version" instead of empty data, and that call is free.

Can I search Goodreads with parameters?

Yes. Fill in query, page: we build the Goodreads search URL, and the call is that URL with recipe=goodreads/listing. A single call with the parameters and no URL is coming to the API; it is not live yet.

Developer guide: settings, pagination, troubleshootingHow to scrape Goodreads: live status, URL patterns, the recipe rules and runnable code.

Related recipes

All recipes

Logos and names belong to their owners. Ujeebu is not affiliated with Goodreads.

Get Goodreads data as JSON today.

5,000 free credits for 7 days. No card.