isbndb
Module isbndb
API
![](https://bcentral-dev-packageicons.azureedge.net/images/ballerinax_isbndb_1.3.0.png)
ballerinax/isbndb Ballerina library
Overview
This is a generated connector for ISBNdb API v2.0.0 OpenAPI specification.
The ISBNdb.com API exposes data such as title, author, publisher and publish date about books.
Clients![](/images/permalink.svg)
isbndb: Client![](/images/permalink.svg)
This is a generated connector for ISBNdb API v2.0.0 OpenAPI specification. The ISBNdb.com API exposes data such as title, author, publisher and publish date about books.
Constructor![](/images/permalink.svg)
Gets invoked to initialize the connector
.
The connector initialization requires setting the API credentials.
Create a ISBNdb Account by selecting a pricing plan and obtain tokens following this guide.
init (ApiKeysConfig apiKeyConfig, ClientConfiguration clientConfig, string serviceUrl)
- apiKeyConfig ApiKeysConfig - API keys for authorization
- clientConfig ClientConfiguration {} - The configurations to be used when initializing the
connector
- serviceUrl string "https://api2.isbndb.com/" - URL of the target service
getAuthorDetails![](/images/permalink.svg)
Gets author details
Parameters
- name string - The name of an author in the Author's database
- page int (default 1) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
- pageSize int (default 20) - How many items should be returned per page, maximum of 1,000
searchAuthors![](/images/permalink.svg)
function searchAuthors(string query, string? pageSize, string? page) returns AuthorQueryResults|error
Search authors
Parameters
- query string - A string to search for in the Author’s database
- pageSize string? (default ()) - How many items should be returned per page, maximum of 1,000
- page string? (default ()) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
Return Type
- AuthorQueryResults|error - The query string found results in the author's database
getBookDetails![](/images/permalink.svg)
Gets book details
Parameters
- isbn string - an ISBN 10 or ISBN 13 in the Books database
- withPrices string? (default ()) - indicate if shows Real Time Prices. Only with the Pro plan
searchBooks![](/images/permalink.svg)
Search books
Parameters
- payload BooksBody - Request payload to search to search books
searchBooksByQuery![](/images/permalink.svg)
function searchBooksByQuery(string query, int page, int pageSize, string? column, int beta) returns Response|error
Search books
Parameters
- query string - A string to search for in the Book’s database
- page int (default 1) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
- pageSize int (default 20) - How many items should be returned per page, maximum of 1,000
- column string? (default ()) - Search limited to this column: *
- Empty value search in every column * `title` - Only searches in Books Title * `author` - Only searches books by the given Author * `date_published` - Only searches books in a given year, e.g. 1998 MISSING[
]+ beta - A integer (1 or 0) for enable or disable beta searching.- return - The query string found results in the books's database
- beta int (default 0) -
getPublisherDetails![](/images/permalink.svg)
Gets publisher details
Parameters
- name string - The name of a publisher in the Publisher's database
- page int (default 1) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
- pageSize int (default 20) - How many items should be returned per page, maximum of 1,000
searchPublishers![](/images/permalink.svg)
Search publishers
Parameters
- query string - A string to search for in the Publisher’s database
- pageSize string? (default ()) - How many items should be returned per page, maximum of 1,000
- page string? (default ()) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
searchISBNDB![](/images/permalink.svg)
function searchISBNDB(string index, string? page, string? pageSize, string? isbn, string? isbn13, string? author, string? text, string? subject, string? publisher) returns Response|error
Search all ISBNDB databases
Parameters
- index string - Only this values are valids: subjects, publishers, authors y books
- page string? (default ()) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
- pageSize string? (default ()) - How many items should be returned per page, maximum of 1,000
- isbn string? (default ()) - an ISBN 10 in the Books database
- isbn13 string? (default ()) - an ISBN 13 in the Books database
- author string? (default ()) - The name of an author in the Author's database
- text string? (default ()) - A string to search for determinated index database
- subject string? (default ()) - A subject in the Subject's database
- publisher string? (default ()) - The name of a publisher in the Publisher's database
getISBNDBStatus![](/images/permalink.svg)
Gets status on the ISBNDB Database
getSubjectDetails![](/images/permalink.svg)
Gets subject details
Parameters
- name string - A subject in the Subject's database
searchSubject![](/images/permalink.svg)
Search subjects
Parameters
- query string - A string to search for in the Subject’s database
- pageSize string? (default ()) - How many items should be returned per page, maximum of 1,000
- page string? (default ()) - The number of page to retrieve, please note the API will not return more than 10,000 results no matter how you paginate them
Records![](/images/permalink.svg)
isbndb: ApiKeysConfig![](/images/permalink.svg)
Provides API key configurations needed when communicating with a remote HTTP endpoint.
Fields
- authorization string - All requests on the ISBNdb.com API needs to include an API key. The API key can be provided as part of the query string or as a request header. The name of the API key needs to be
Authorization
.
isbndb: Author![](/images/permalink.svg)
Describes the name of an author and the books written by that author in the database
Fields
- author string? - Author name
- books Book[]? - Detail about books written by author
isbndb: AuthorQueryResults![](/images/permalink.svg)
Describes the results of a query in the author's database
Fields
- total int? -
- authors string[]? -
isbndb: Book![](/images/permalink.svg)
Describes a book in the book's database
Fields
- title string? -
- title_long string? -
- isbn string? -
- isbn13 string? -
- dewey_decimal string? -
- binding string? -
- publisher string? -
- language string? -
- date_published string? -
- edition string? -
- pages int? -
- dimensions string? -
- overview string? -
- image CoverLink? - The link to the cover image
- msrp decimal? -
- excerpt string? -
- synopsys string? -
- authors string[]? -
- subjects string[]? -
- reviews string[]? -
- prices Merchant[]? - Only shows if the query param 'with_prices' is present.
- related BookRelated? -
isbndb: BookRelated![](/images/permalink.svg)
Fields
- 'type string? -
isbndb: BooksBody![](/images/permalink.svg)
Fields
- isbns string[] - a list of ISBN 10 or ISBN 13 in the Books database
isbndb: BooksBody1![](/images/permalink.svg)
Fields
- isbns string[] - a list of ISBN 10 or ISBN 13 in the Books database
isbndb: Merchant![](/images/permalink.svg)
Describe the conditions of the price by merchant. Only with the Pro plan
Fields
- condition string? -
- merchant string? -
- merchant_logo string? -
- merchant_logo_offset MerchantMerchantLogoOffset? -
- shipping string? -
- price string? -
- total string? -
- link string? -
isbndb: MerchantMerchantLogoOffset![](/images/permalink.svg)
Fields
- x string? - Merchant logo x-offset
- y string? - Merchant logo y-offset
isbndb: Publisher![](/images/permalink.svg)
Describes about book publisher details
Fields
- name string? - Name of book publisher
- books PublisherBooks[]? - Details of books published
isbndb: PublisherBooks![](/images/permalink.svg)
Details of books published
Fields
- isbn string? -
isbndb: Subject![](/images/permalink.svg)
Describes about what the book is about
Fields
- subject string? -
- parent string? -
String types![](/images/permalink.svg)
isbndb: CoverLink![](/images/permalink.svg)
CoverLink
The link to the cover image
Import
import ballerinax/isbndb;
Metadata
Released date: over 1 year ago
Version: 1.3.0
License: Apache-2.0
Compatibility
Platform: any
Ballerina version: 2201.2.1
GraalVM compatible: Yes
Pull count
Total: 0
Current verison: 0
Weekly downloads
Keywords
Lifestyle & Entertainment/Books
Cost/Paid
Contributors
Dependencies