OpenAPI Specification
openapi: 3.0.0
info:
title: ISBNdb API v2 Author Search 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: Search
description: Legacy search endpoints (deprecated)
paths:
/search/authors:
get:
tags:
- Search
summary: Search authors (deprecated)
description: '*Deprecated* use /authors/{query}
Uses a determined index and query string to search in any of the ISBNDB''s databases'
operationId: get_app_api_search_searchauthors__invoke
deprecated: true
parameters:
- name: text
in: query
required: true
schema:
type: string
- name: page
in: query
required: false
schema:
type: integer
nullable: true
default: 1
- name: pageSize
in: query
required: false
schema:
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/SearchBaseResponse'
security:
- ApiKeyAuth: []
/search/books:
get:
tags:
- Search
summary: Search books
description: Uses a determined index and query string to search in any of the ISBNDB's databases
operationId: get_app_api_search_searchbooks__invoke
parameters:
- name: page
in: query
required: false
schema:
type: integer
nullable: true
default: 1
- name: pageSize
in: query
required: false
schema:
type: integer
nullable: true
default: 20
- name: isbn
in: query
description: an ISBN 10 in the Books database
required: false
schema:
type: string
nullable: true
maxLength: 20
- name: isbn13
in: query
description: an ISBN 13 in the Books database
required: false
schema:
type: string
nullable: true
maxLength: 20
- name: author
in: query
description: The name of an author in the Author's database
required: false
schema:
type: string
nullable: true
maxLength: 150
- name: text
in: query
description: A string to search for determinated index database
required: false
schema:
type: string
nullable: true
maxLength: 150
- name: subject
in: query
description: A subject in the Subject's database
required: false
schema:
type: string
nullable: true
maxLength: 150
- name: publisher
in: query
description: The name of a publisher in the Publisher's database
required: false
schema:
type: string
nullable: true
maxLength: 150
- name: publishedFrom
in: query
required: false
schema:
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
required: false
schema:
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: The query string found results in the books's database
content:
application/json:
schema:
$ref: '#/components/schemas/SearchBookResponse'
security:
- ApiKeyAuth: []
/search/publishers:
get:
tags:
- Search
summary: Search publishers (deprecated)
description: '*Deprecated* use /publishers/{query}
Uses a determined index and query string to search in any of the ISBNDB''s databases'
operationId: get_app_api_search_searchpublishers__invoke
deprecated: true
parameters:
- name: text
in: query
required: true
schema:
type: string
- name: page
in: query
required: false
schema:
type: integer
nullable: true
default: 1
- name: pageSize
in: query
required: false
schema:
type: integer
nullable: true
default: 20
responses:
'200':
description: The query string found results in the publisher's database
content:
application/json:
schema:
$ref: '#/components/schemas/SearchBaseResponse'
security:
- ApiKeyAuth: []
/search/subjects:
get:
tags:
- Search
summary: Search subjects (deprecated)
description: '*Deprecated* use /subjects/{query}
Uses a determined index and query string to search in any of the ISBNDB''s databases'
operationId: get_app_api_search_searchsubjects__invoke
deprecated: true
parameters:
- name: text
in: query
required: true
schema:
type: string
- name: page
in: query
required: false
schema:
type: integer
nullable: true
default: 1
- name: pageSize
in: query
required: false
schema:
type: integer
nullable: true
default: 20
responses:
'200':
description: The query string found results in the subjects's database
content:
application/json:
schema:
$ref: '#/components/schemas/SearchBaseResponse'
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
SearchBaseResponse:
required:
- name
- data
- total
- page
- page_size
properties:
name:
type: string
data:
type: array
items:
type: string
total:
type: integer
page:
type: integer
page_size:
type: integer
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
SearchBookResponse:
required:
- data
- total
- page
- page_size
properties:
data:
type: array
items:
$ref: '#/components/schemas/Book'
total:
type: integer
page:
type: integer
page_size:
type: integer
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
Point:
required:
- x
- y
properties:
x:
type: string
y:
type: string
type: object
securitySchemes:
ApiKeyAuth:
type: apiKey
name: Authorization
in: header