apyhub
Back
STANDARD DATA

Search Books & Authors API

What it does

Book Search API provides access to a catalog of books and authors. It allows you to search for authors, search and filter books, retrieve detailed information for a specific book, and find books similar to a given title.

Use it when you need book catalog data for reading applications, book discovery and search, recommendation features, library tools, catalog enrichment, or internal knowledge systems.

Search Authors lets you find authors by name with optional pagination using number and offset. Search Books supports free-text search and filtering by ISBN, OCLC number, author, genre, rating, publication year, result grouping, sorting, and pagination.

Get Book Information retrieves detailed information for a specific book, including its title, subtitle, cover image, external identifiers, authors, publication details, description, and rating. Find Similar Books returns a list of books related to a specified book, with an optional number parameter to control the number of results.

The API returns structured JSON responses that can be used directly in search interfaces, book discovery workflows, recommendation systems, and catalog enrichment pipelines.

▣ ENDPOINT 01 / 04
GET
Search Authors
https://api.eu.apyhub.com/skycraft/big-book-api/search-authors

QUICKSTART

GUIDE

Quickstart

Fetch a book result by passing the required query parameters in the URL.

curl -X GET "https://api.eu.apyhub.com/skycraft/big-book-api/search-authors?name=Morgan%20Housel&number=10&offset=0" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing a list of matching authors.

{
  "authors": [
    {
      "id": 22313234,
      "name": "Morgan Housel"
    }
  ]
}
TRY ITLIVE · 20 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches the author catalogue by name and returns the matching authors with their ids.

Query Parameter(s)

AttributeTypeMandatoryDescription
nameStringNoAuthor name to search for.
numberNumberNoNumber of results to return.
offsetNumberNoNumber of results to skip before starting the returned page.

Response

Returns a JSON object containing an authors array. Each author object includes the author's unique id and name.

FieldTypeDescription
authorsArrayList of matching authors.
authors[].idNumberUnique identifier of the author.
authors[].nameStringName of the author.

Query parameters

Name
Type
Description
nameOPTIONAL
string
numberOPTIONAL
number
offsetOPTIONAL
number
▣ ENDPOINT 02 / 04
GET
Search Books
https://api.eu.apyhub.com/skycraft/big-book-api/search-books

QUICKSTART

GUIDE

Quickstart

Search the book catalog with a few common query filters.

curl -X GET "https://api.eu.apyhub.com/skycraft/big-book-api/search-books?query=books%20about%20wizards&sort=rating&number=10" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing the matching books along with pagination and rating information.

{
  "available": 6260,
  "number": 10,
  "offset": 0,
  "books": [
    [
      {
        "id": 13043102,
        "title": "Crimson Tide Madness",
        "subtitle": "Great Eras in Alabama Football (Golden Ages of College Sports)",
        "image": "https://covers.openlibrary.org/b/id/1942923-M.jpg",
        "authors": [
          {
            "id": 13043088,
            "name": "Wilton Sharpe"
          }
        ],
        "rating": {
          "average": 1
        }
      }
    ]
  ],
  "expires": 1790771703776
}
TRY ITLIVE · 20 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Searches books by ISBN, OCLC, free-text query, genre, author, rating and publication year, with paging and sort options. All filters are query parameters.

Query Parameter(s)

AttributeTypeMandatoryDescription
isbnStringNoISBN to search by.
oclcStringNoOCLC number to search by.
sortStringNoSort field for the search results.
queryStringNoSearch text query.
genresStringNoGenre filter.
numberNumberNoNumber of results to return.
offsetNumberNoResult offset for pagination.
authorsStringNoAuthor filter.
max-ratingNumberNoMaximum rating filter.
min-ratingNumberNoMinimum rating filter.
group-resultsBooleanNoWhether to group results.
sort-directionStringNoSort direction.
latest-publish-yearNumberNoLatest publish year filter.
earliest-publish-yearNumberNoEarliest publish year filter.

Response

Returns a JSON object containing the total number of available books, pagination details, and a list of matching books. Each book includes its ID, title, optional subtitle and image, author information, and rating.

FieldTypeDescription
availableNumberTotal number of books available for the search.
numberNumberNumber of books returned in the response.
offsetNumberNumber of results skipped before the returned results.
booksArrayList of result groups. Each group is an array of book objects.
books[][].idNumberUnique identifier of the book.
books[][].titleStringTitle of the book.
books[][].subtitleStringSubtitle, when available.
books[][].imageStringCover image URL, when available.
books[][].authorsArrayAuthors of the book.
books[][].ratingObjectRating information.
books[].rating.averageNumberAverage rating of the book.
expiresNumberExpiration timestamp for the response.

Query parameters

Name
Type
Description
isbnOPTIONAL
string
oclcOPTIONAL
string
sortOPTIONAL
string
queryOPTIONAL
string
genresOPTIONAL
string
numberOPTIONAL
number
offsetOPTIONAL
number
authorsOPTIONAL
string
max-ratingOPTIONAL
number
min-ratingOPTIONAL
number
group-resultsOPTIONAL
boolean
sort-directionOPTIONAL
string
latest-publish-yearOPTIONAL
number
earliest-publish-yearOPTIONAL
number
▣ ENDPOINT 03 / 04
GET
Get Book Information
https://api.eu.apyhub.com/skycraft/big-book-api/:id

QUICKSTART

GUIDE

Quickstart

Fetch a book by its id by putting the path parameter in the URL.

curl -X GET "https://api.eu.apyhub.com/skycraft/big-book-api/:id" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing detailed information about the requested book.

{
  "id": 13043102,
  "title": "Crimson Tide Madness",
  "subtitle": "Great Eras in Alabama Football (Golden Ages of College Sports)",
  "image": "https://covers.openlibrary.org/b/id/1942923-M.jpg",
  "identifiers": {
    "open_library_id": "OL5821286W",
    "isbn_10": "1581825803",
    "isbn_13": "1581825803"
  },
  "authors": [
    {
      "id": 13043088,
      "name": "Wilton Sharpe"
    }
  ],
  "publish_date": 2007,
  "number_of_pages": 272,
  "description": "A Tradition of Greatness Twelve national championships, twenty-one SEC championships, twenty College Football Hall of Famers, and the most legendary coach in college football history.",
  "rating": {
    "average": 1
  }
}
TRY ITLIVE · 20 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Retrieves information for a specific book identified by its id.

Path Parameter(s)

AttributeTypeMandatoryDescription
idNumberYesThe book identifier.

Response

Returns a JSON object containing detailed information about the requested book, including its title, subtitle, cover image, identifiers, authors, publication date, page count, description, and rating.

FieldTypeDescription
idNumberUnique identifier of the book.
titleStringTitle of the book.
subtitleStringSubtitle of the book, when available.
imageStringURL of the book cover image.
identifiersObjectExternal identifiers associated with the book.
identifiers.open_library_idStringOpen Library identifier of the book.
identifiers.isbn_10StringISBN-10 identifier of the book.
identifiers.isbn_13StringISBN-13 identifier of the book.
authorsArrayList of authors associated with the book.
authors[].idNumberUnique identifier of the author.
authors[].nameStringName of the author.
publish_dateNumberYear in which the book was published.
number_of_pagesNumberNumber of pages in the book.
descriptionStringDescription or summary of the book.
ratingObjectRating information for the book.
rating.averageNumberAverage rating of the book.

Path parameters

Name
Type
Description
idREQUIRED
string
▣ ENDPOINT 04 / 04
GET
Find Similar Books
https://api.eu.apyhub.com/skycraft/big-book-api/:id/similar

QUICKSTART

GUIDE

Quickstart

Fetch the book by its required path id, with the optional number query parameter if needed.

curl -X GET "https://api.eu.apyhub.com/skycraft/big-book-api/:id/similar" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object containing books similar to the requested book.

{
  "similar_books": [
    {
      "id": 20920732,
      "title": "Always Alabama",
      "subtitle": "A History of Crimson Tide Football",
      "image": "https://covers.openlibrary.org/b/id/475562-M.jpg"
    },
    {
      "id": 20107962,
      "title": "Crimson Nation",
      "subtitle": "The Shaping of the South's Most Dominant Football Team",
      "image": "https://covers.openlibrary.org/b/id/750106-M.jpg"
    }
  ]
}
TRY ITLIVE · 20 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Finds books similar to the one identified by the id path parameter. Use the optional number query parameter to control how many are returned.

Path Parameter(s)

AttributeTypeMandatoryDescription
idNumberYesBook identifier.

Query Parameter(s)

AttributeTypeMandatoryDescription
numberNumberNoNumber of similar books to return.

Response

Returns a JSON object containing a list of books similar to the requested book. Each similar book includes its unique ID, title, and cover image, with an optional subtitle when available.

FieldTypeDescription
similar_booksArrayList of books similar to the requested book.
similar_books[].idNumberUnique identifier of the similar book.
similar_books[].titleStringTitle of the similar book.
similar_books[].subtitleStringSubtitle of the similar book, when available.
similar_books[].imageStringURL of the similar book's cover image.

Path parameters

Name
Type
Description
idREQUIRED
string

Query parameters

Name
Type
Description
numberOPTIONAL
number
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.