ratings.json: Get ratings for a work

API: openlibrary.org:open-library-api
Endpoint: /works/{id}/ratings.json
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 732ms

Description

Returns aggregated community rating data for a work including the average rating (1-5 scale), total number of ratings, and a breakdown of how many users gave each star rating. Use this to display community sentiment and quality assessment for a book.

From spec: Retrieve user ratings for a work.

Usage Tips

- Use a valid work ID like 'OL1168083W' (found in the 'key' field from search results) - Average is on a 5-star scale - 'sortable' is a weighted average used for ranking - Returns 404 if the work ID does not exist or has no ratings - Consider caching this data as it changes slowly

Parameters (1)

id (string, path, required)

Work ID

Examples (1)

Get community ratings for George Orwell's 1984 probe-gate

Demonstrates fetching aggregated user ratings and star distribution for a work

curl 'https://openlibrary.org/works/OL1168083W/ratings.json'
import requests

resp = requests.get("https://openlibrary.org/works/OL1168083W/ratings.json")
data = resp.json()
import zingu_apis

api = zingu_apis.api("openlibrary")
result = api.fetch("works/{id}/ratings.json")

for item in result:
    print(item)
const resp = await fetch("https://openlibrary.org/works/OL1168083W/ratings.json");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 01:25:35.556563 200 732ms
2026-04-15 03:05:52.042330 200 618ms
2026-04-14 01:48:22.499357 200 18951ms
2026-04-12 16:32:28.693967 200 4787ms
2026-04-10 05:09:15.093997 200 2175ms
2026-04-09 00:17:40.538190 200 795ms