Skip to content
GET /v1/subject

The most-held books in a subject/genre

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/readingtrends-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/readingtrends-api/v1/subject" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/readingtrends-api/v1/subject", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/readingtrends-api/v1/subject");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/readingtrends-api/v1/subject",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "books": [
            {
                "id": "OL138052W",
                "url": "https://openlibrary.org/works/OL138052W",
                "rank": 1,
                "title": "Alice's Adventures in Wonderland",
                "author": "Lewis Carroll",
                "authors": [
                    "Lewis Carroll"
                ],
                "cover_id": 10527843,
                "edition_count": 3547,
                "first_published": 1865
            },
            {
                "id": "OL18417W",
                "url": "https://openlibrary.org/works/OL18417W",
                "rank": 2,
                "title": "The Wonderful Wizard of Oz",
                "author": "L. Frank Baum",
                "authors": [
                    "L. Frank Baum"
                ],
                "cover_id": 552443,
                "edition_count": 2049,
                "first_published": 1899
            },
            {
                "id": "OL24034W",
                "url": "https://openlibrary.org/works/OL24034W",
                "rank": 3,
                "title": "Treasure Island",
                "author": "Robert Louis Stevenson",
                "authors": [
                    "Robert Louis Stevenson"
                ],
                "cover_id": 13859660,
                "edition_count": 1988,
                "first_published": 1880
            },
            {
                "id": "OL20600W",
                "url": "https://openlibrary.org/works/OL20600W",
                "rank": 4,
                "title": "Gulliver's Travels",
                "author": "Jonathan Swift",
                "authors": [
                    "Jonathan Swift"
                ],
                "cover_id": 12717083,
                "edition_count": 1810,
                "first_published": 1726
            },
            {
                "id": "OL259010W",
                "url": "https://openlibrary.org/works/OL259010W",
                "rank": 5,
                "title": "A Midsummer Night's Dream",
                "author": "William Shakespeare",
                "authors": [
                    "William Shakespeare"
                ],
                "cover_id": 7205924,
                "edition_count": 1505,
                "first_published": 1600
            },
            {
                "id": "OL1089297W",
                "url": "https://openlibrary.org/works/OL1089297W",
                "rank": 6,
                "title": "The Prince",
                "author": "Niccolò Machiavelli",
                "authors": [
                    "Niccolò Machiavelli"
                ],
                "cover_id": 12726168,
                "edition_count": 1407,
                "first_published": 1515
            },
            {
                "id": "OL151406W",
                "url": "https://openlibrary.org/works/OL151406W",
                "rank": 7,
                "title": "Through the Looking-Glass",
                "author": 
…