Books API

List, search, and retrieve book metadata. All book content is read-only through this API; purchases happen through the main InceNar platform.

GET/v1/booksBasic+

Returns a paginated list of published books with optional filtering.

Parameters

Name	Type	Default	Description
page	integer	1	Page number
limit	integer	20	Items per page (max 50)
category	string	—	Filter by category slug (e.g., "fiction", "romance")
language	string	—	ISO 639-1 language code (e.g., "en", "es")
sort	string	published_at	Sort field: published_at, rating, sales_count, price
order	string	desc	Sort order: asc or desc
minPrice	number	—	Minimum price filter
maxPrice	number	—	Maximum price filter
q	string	—	Full-text search query

Response Example

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "The Great Novel",
      "description": "A thrilling adventure...",
      "price": 9.99,
      "currency": "USD",
      "language": "en",
      "categories": ["fiction", "adventure"],
      "rating": 4.8,
      "reviewCount": 127,
      "salesCount": 5432,
      "coverUrl": "https://cdn.incenar.com/covers/...",
      "badges": {
        "featured": true,
        "topSeller": false
      },
      "publishing": {
        "mode": "complete",
        "chapterCount": 0,
        "publishedAt": "2026-03-15T00:00:00Z"
      },
      "author": {
        "id": "...",
        "name": "Jane Smith",
        "imageUrl": "https://cdn.incenar.com/authors/..."
      },
      "links": {
        "self": "/v1/books/550e8400-e29b-41d4-a716-446655440000",
        "author": "/v1/authors/..."
      }
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 15420,
    "totalPages": 772,
    "hasMore": true
  }
}

GET/v1/books/{id}Basic+

Retrieve detailed information about a specific book.

Parameters

Name	Type	Default	Description
id*	uuid	—	Book unique identifier

Response Example

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "The Great Novel",
    "description": "...",
    "contentPreview": "The first 1000 characters...",
    "price": 9.99,
    "originalPrice": 14.99,
    "currency": "USD",
    "authorNote": "Thank you for reading...",
    "rating": 4.8,
    "reviewCount": 127,
    "salesCount": 5432,
    "coverUrl": "...",
    "badges": { "featured": true, "topSeller": false },
    "publishing": {
      "mode": "serial",
      "chapterCount": 24,
      "publishedAt": "2026-03-15T00:00:00Z"
    },
    "author": {
      "id": "...",
      "name": "DR R",
      "imageUrl": "...",
      "bio": "Award-winning author..."
    },
    "links": {
      "self": "/v1/books/...",
      "chapters": "/v1/books/.../chapters",
      "purchase": "/v1/books/.../purchase",
      "author": "/v1/authors/..."
    }
  }
}