GET /subjects/{subject}.json

openlibrary.org:open-library-api

Summary: Get works by subject
Operation ID: getSubject
Auth: none
Description

Retrieve books and works associated with a specific subject/topic.

Parameters (4)

details (boolean, query, optional, default: False)

Include additional details

limit (integer, query, optional)

Number of works to return

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

offset (integer, query, optional)

Offset for pagination

Constraints: {'minimum': 0}

subject (string, path, required)

Subject name (URL-encoded if contains spaces)

Examples (4)

TitleTypeURLAction
Get subject information openapi-spec https://openlibrary.org/subjects/science.json
Get works by subject openapi-spec https://openlibrary.org/subjects/science_fiction.json
Get works by subject openapi-spec https://openlibrary.org/subjects/love.json
Get works by subject probe-gate https://openlibrary.org/subjects/love.json?details=False

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-03-23 10:25:48.140822 200 990ms
2026-03-23 09:35:41.501664 200 769ms
2026-03-23 09:34:24.354737 200 954ms
2026-03-23 09:19:43.044258 200 663ms

Response Changes

WhenOldNew
2026-03-23 09:34:24.354737 366217bb807d a31470be5885
2026-03-23 09:35:41.501664 a31470be5885 aaab8cc97496
2026-03-23 10:25:48.140822 aaab8cc97496 27b9dc7c1b5c