Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/search

Reading-engagement search — books with rating and shelf counts

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/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/readingtrends-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/readingtrends-api/v1/search");
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/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

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

{
    "data": {
        "books": [
            {
                "id": "OL893415W",
                "url": "https://openlibrary.org/works/OL893415W",
                "title": "Dune",
                "author": "Frank Herbert",
                "authors": [
                    "Frank Herbert"
                ],
                "cover_id": 11481354,
                "already_read": 686,
                "rating_count": 426,
                "want_to_read": 3291,
                "edition_count": 120,
                "rating_average": 4.31,
                "first_published": 1965,
                "currently_reading": 251
            },
            {
                "id": "OL893526W",
                "url": "https://openlibrary.org/works/OL893526W",
                "title": "Dune Messiah",
                "author": "Frank Herbert",
                "authors": [
                    "Frank Herbert"
                ],
                "cover_id": 2421405,
                "already_read": 244,
                "rating_count": 137,
                "want_to_read": 530,
                "edition_count": 70,
                "rating_average": 3.96,
                "first_published": 1969,
                "currently_reading": 41
            },
            {
                "id": "OL893516W",
                "url": "https://openlibrary.org/works/OL893516W",
                "title": "Children of Dune",
                "author": "Frank Herbert",
                "authors": [
                    "Frank Herbert"
                ],
                "cover_id": 6976407,
                "already_read": 130,
                "rating_count": 46,
                "want_to_read": 270,
                "edition_count": 51,
                "rating_average": 3.96,
                "first_published": 1976,
                "currently_reading": 21
            },
            {
                "id": "OL893502W",
                "url": "https://openlibrary.org/works/OL893502W",
                "title": "Heretics of Dune",
                "author": "Frank Herbert",
                "authors": [
                    "Frank Herbert"
                ],
                "cover_id": 284530,
                "already_read": 91,
                "rating_count": 50,
                "want_to_read": 131,
                "edition_count": 35,
                "rating_average": 3.86,
                "first_published": 1984,
                "currently_reading": 7
            },
            {
                "id": "OL893515W",
                "url": "https://openlibrary.org/works/OL893515W",
                "title": "God Emperor of Dune",
                "author": "Frank Herbert",
                "authors": [
                    "Frank Herbert"
                ],
                "cover_id": 6711531,
                "already_read": 131,
                "rating_count": 74,
                "want_to_read": 165,
                "edition_count": 40,
                "rating_average": 3.95,
                "first_published": 1
…