OpenAPI Specification
openapi: 3.0.0
info:
title: ISBNdb API v2 Author API
description: "Definition of ISBNdb.com API v2.\n\n***Note: A 404 Not Found response for an ISBN lookup typically\nindicates that the book information is not yet available in our database.\nHowever, due to frequent updates, there is a high probability that the data will be \nadded shortly, often within a minute or up to 24 hours. We recommend trying your request \nagain after a while, as the information may soon become accessible***\n"
version: 2.7.0
servers:
- url: https://api2.isbndb.com
description: API Endpoint
tags:
- name: Author
description: Author endpoints
paths:
/author/{name}:
get:
tags:
- Author
summary: Gets author details
description: Returns the name and a list of books by the author.
operationId: get_app_api_author_authordetails__invoke
parameters:
- name: name
in: path
description: 'The author name. **Max length: 150 characters**.'
required: true
schema:
type: string
- name: language
in: query
description: Language code to filter books by language (e.g., `eng` for English, `fra` for French, etc.)
required: false
schema:
description: Language code to filter books by language (e.g., `eng` for English, `fra` for French, etc.)
type: string
nullable: true
default: null
maxLength: 50
- name: page
in: query
description: The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
required: false
schema:
description: The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
type: integer
nullable: true
default: 1
- name: pageSize
in: query
description: How many items should be returned per page, maximum of 1,000
required: false
schema:
description: How many items should be returned per page, maximum of 1,000
type: integer
nullable: true
default: 20
- name: publishedFrom
in: query
description: 'Filter books published on or after this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter.'
required: false
schema:
description: 'Filter books published on or after this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter.'
type: string
pattern: .*(^\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?)?$).*
nullable: true
default: null
- name: publishedTo
in: query
description: 'Filter books published on or before this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter.'
required: false
schema:
description: 'Filter books published on or before this date. Accepted formats: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Cannot be combined with the `year` parameter.'
type: string
pattern: .*(^\d{4}(-(0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?)?$).*
nullable: true
default: null
responses:
'200':
description: Returns the book details
content:
application/json:
schema:
$ref: '#/components/schemas/AuthorDetailsResponse'
security:
- ApiKeyAuth: []
/authors/{query}:
get:
tags:
- Author
summary: Search authors
description: This returns a list of authors whos name matches the given query
operationId: get_app_api_author_searchauthors__invoke
parameters:
- name: query
in: path
description: 'The search query string. **Max length: 150 characters**.'
required: true
schema:
type: string
- name: page
in: query
description: The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
required: false
schema:
description: The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
type: integer
nullable: true
default: 1
- name: pageSize
in: query
description: How many items should be returned per page, maximum of 1,000
required: false
schema:
description: How many items should be returned per page, maximum of 1,000
type: integer
nullable: true
default: 20
responses:
'200':
description: The query string found results in the author's database
content:
application/json:
schema:
$ref: '#/components/schemas/SearchAuthorsResponse'
security:
- ApiKeyAuth: []
components:
schemas:
RelatedIsbn:
required:
- isbn
- binding
properties:
isbn:
description: ISBN-13 of the related edition
type: string
binding:
description: Binding type of the related edition (e.g. Hardcover, Paperback)
type: string
type: object
Price:
required:
- condition
- merchant
- merchant_logo
- merchant_logo_offset
- shipping
- price
- total
- link
properties:
condition:
description: Condition of the book offered at this price (e.g. new, used, digital)
type: string
merchant:
description: Name of the merchant offering this price
type: string
merchant_logo:
description: URL of the merchant logo image
type: string
merchant_logo_offset:
$ref: '#/components/schemas/Point'
shipping:
description: Shipping cost for this offer
type: string
price:
description: Item price excluding shipping
type: string
total:
description: Total price including shipping
type: string
link:
description: URL to purchase the book from this merchant
type: string
type: object
Book:
required:
- title
- title_long
- isbn
- isbn13
- date_published
properties:
title:
description: Title
type: string
title_long:
description: Long title (deprecated)
type: string
deprecated: true
isbn:
description: ISBN-13 (deprecated, use isbn13)
type: string
deprecated: true
isbn13:
description: ISBN-13
type: string
isbn10:
description: Book ISBN-10, if available
type: string
nullable: true
dewey_decimal:
description: Dewey Decimal Classification numbers assigned to the book
type: array
items:
type: string
nullable: true
binding:
description: Book binding type (e.g. Hardcover, Paperback, eBook)
type: string
nullable: true
publisher:
description: Name of the publisher
type: string
nullable: true
language:
description: Language of the book (ISO 639-1 code or full name)
type: string
nullable: true
date_published:
description: A publication date in YYYY-MM-DD, YYYY-MM, or YYYY format.
type: string
format: date
example: '2023-10-26'
edition:
description: Edition of the book (e.g. 3rd, Revised)
type: string
nullable: true
pages:
description: Number of pages in the book
type: integer
nullable: true
dimensions:
description: Physical dimensions of the book as a formatted string (deprecated)
type: string
nullable: true
deprecated: true
dimensions_structured:
description: Structured physical dimensions of the book
nullable: true
oneOf:
- type: array
items:
nullable: true
- type: object
additionalProperties:
nullable: true
overview:
description: Brief overview or description of the book (deprecated)
type: string
nullable: true
deprecated: true
image:
description: Image link. Maximum height is 500px.
type: string
nullable: true
image_original:
description: 'Original image link. Note: This URL is temporary and will expire 2 hours after the API response is generated.'
type: string
nullable: true
msrp:
description: Manufacturer's suggested retail price
type: number
format: float
nullable: true
excerpt:
description: Short excerpt from the book
type: string
nullable: true
synopsis:
description: Full synopsis or summary of the book
type: string
nullable: true
authors:
description: List of authors of the book
type: array
items:
type: string
nullable: true
subjects:
description: List of subjects or categories the book belongs to
type: array
items:
type: string
nullable: true
reviews:
description: User or editorial reviews of the book (deprecated)
type: array
items:
type: string
nullable: true
deprecated: true
prices:
description: Available prices from various merchants
type: array
items:
$ref: '#/components/schemas/Price'
nullable: true
related:
description: Related books (deprecated)
nullable: true
deprecated: true
oneOf:
- type: array
items:
nullable: true
- type: object
additionalProperties:
nullable: true
other_isbns:
description: Other ISBNs associated with this book (e.g. different formats or editions)
type: array
items:
$ref: '#/components/schemas/RelatedIsbn'
nullable: true
type: object
AuthorDetailsResponse:
required:
- author
- name
- books
- total
- page
- page_size
properties:
author:
type: string
name:
type: string
books:
type: array
items:
$ref: '#/components/schemas/Book'
total:
type: integer
page:
type: integer
page_size:
type: integer
type: object
SearchAuthorsResponse:
required:
- name
- authors
- total
- page
- page_size
properties:
name:
type: string
authors:
type: array
items:
type: string
total:
type: integer
page:
type: integer
page_size:
type: integer
type: object
Point:
required:
- x
- y
properties:
x:
type: string
y:
type: string
type: object
securitySchemes:
ApiKeyAuth:
type: apiKey
name: Authorization
in: header