openBD

https://openbd.jp
Admin
openBD is a free API service that provides bibliographic information and book cover images at high...
Tokens:3,621
Snippets:39
Trust Score:7.7
Update:5 months ago
Show doc for...
Tokens:
Raw
### Get Coverage Information

Source: https://openbd.jp/

Retrieve information about the scope of data available through the openBD API.

```APIDOC
## GET /coverage

### Description
Provides information on the extent and range of bibliographic data covered by the openBD API.

### Method
GET

### Endpoint
/coverage

### Parameters
None

### Response
#### Success Response (200)
- **(JSON Object)** - Details about the data coverage.

#### Response Example
{
  "total_titles": 760000,
  "publishers_included": 24747,
  "last_updated": "2024-01-01"
}
```

--------------------------------

### Get JSON Schema

Source: https://openbd.jp/

Retrieve the JSON schema used by the openBD API for its responses.

```APIDOC
## GET /schema

### Description
Returns the JSON schema that defines the structure of the API's responses, useful for data validation and understanding the data format.

### Method
GET

### Endpoint
/schema

### Parameters
None

### Response
#### Success Response (200)
- **(JSON Object)** - The JSON schema definition.

#### Response Example
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "BibliographicRecord",
  "type": "object",
  "properties": {
    "isbn": {"type": "string"},
    "title": {"type": "string"},
    "author": {"type": "string"},
    "publisher": {"type": "string"},
    "publication_date": {"type": "string", "format": "date"},
    "cover_image_url": {"type": "string", "format": "url"}
  },
  "required": ["isbn", "title", "author", "publisher", "publication_date"]
}
```

--------------------------------

### Get Bibliographic Information

Source: https://openbd.jp/

Retrieve bibliographic information for one or more books using their ISBNs. The API is designed for extremely fast responses, aiming for under 1 millisecond per record.

```APIDOC
## GET /get

### Description
Retrieves bibliographic information for books based on provided ISBNs.

### Method
GET

### Endpoint
/get

### Parameters
#### Query Parameters
- **isbn** (string) - Required - A comma-separated list of ISBNs (e.g., ISBN,ISBN).

### Request Example
GET /get?isbn=9784000613017,9784000613024

### Response
#### Success Response (200)
- **(JSON Object)** - Contains bibliographic data for the requested ISBNs.

#### Response Example
{
  "isbn": "9784000613017",
  "title": "吾輩は猫である",
  "author": "夏目漱石",
  "publisher": "岩波書店",
  "publication_date": "2017-01-18",
  "cover_image_url": "https://example.com/covers/9784000613017.jpg"
}
```
Tokens:
Raw