---
title: "Get a random book"
method: GET
path: "/public/books/book/random"
tags: ["📢 Public APIs"]
---

# Get a random book

`GET /public/books/book/random`

## Request

- Base URL: `https://api.freeapi.app/api/v1`
- URL: `https://api.freeapi.app/api/v1/public/books/book/random`
- Auth: none declared
- TypeScript: <https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi/docs/public/books/book/random/get.ts> (a function with typed inputs; its response is checked against the schema)

The API endpoint returns a single random book from a list of books.

Upon accessing this endpoint, you will receive a response containing the details of a randomly selected book.

## Response `200`

Get a random book

- object
  - `data` object
    - `accessInfo` object
      - `accessViewStatus` string
      - `country` string
      - `embeddable` boolean
      - `epub` object
        - `downloadLink` string
        - `isAvailable` boolean
      - `pdf` object
        - `isAvailable` boolean
      - `publicDomain` boolean
      - `quoteSharingAllowed` boolean
      - `textToSpeechPermission` string
      - `viewability` string
      - `webReaderLink` string
    - `etag` string
    - `id` number
    - `kind` string
    - `saleInfo` object
      - `buyLink` string
      - `country` string
      - `isEbook` boolean
      - `saleability` string
    - `searchInfo` object
      - `textSnippet` string
    - `selfLink` string
    - `volumeInfo` object
      - `allowAnonLogging` boolean
      - `authors` string[]
      - `canonicalVolumeLink` string
      - `categories` string[]
      - `contentVersion` string
      - `description` string
      - `imageLinks` object
        - `smallThumbnail` string
        - `thumbnail` string
      - `industryIdentifiers` object[]
        - `identifier` string
        - `type` string
      - `infoLink` string
      - `language` string
      - `maturityRating` string
      - `pageCount` number
      - `panelizationSummary` object
        - `containsEpubBubbles` boolean
        - `containsImageBubbles` boolean
      - `previewLink` string
      - `printType` string
      - `publishedDate` string
      - `readingModes` object
        - `image` boolean
        - `text` boolean
      - `subtitle` string
      - `title` string
  - `message` string
  - `statusCode` number
  - `success` boolean

---

[API](https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi.md) - [All operations](https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi/llms.txt) - [OpenAPI document](https://skmtc.dev/hiteshchoudhary-ssesph/apis/freeapi/revisions/a9f3a290e4dc?raw)