Genre Data API

Genre Data API Details

The Genre Data API returns BISAC genre records: the code, the full heading, and how many editions in the catalog carry it. Look a genre up by BISAC code, by name, or by ISBNLab id.

Available on the Standard and Pro plans. See Pricing.

To try out the Genre Data API, see the API Documentation

To learn more about the API and how it works, see the API Information

API Documentation API Information

Endpoints

GET /api/genre/search/{search} — a genre by BISAC code (e.g. FIC009020) or the best match for a name.
GET /api/genre/{id} — a genre by ISBNLab id.

An exact BISAC code is the fastest and most reliable lookup. Full BISAC headings contain /, which can't be sent in a URL path, so search by code or by a word from the heading (e.g. epic fantasy). No match is a 404.

Genre Data API Request CURL Example

curl -X 'GET' \
  'https://www.isbnlab.com/api/genre/search/FIC009020' \
  -H 'accept: application/ld+json' \
  -H 'Authorization: Bearer {API_TOKEN}'

Genre Data API Response Example

{
    "@context": "/api/contexts/Genre",
    "@id": "/api/genre/search/FIC009020",
    "@type": "Genre",
    "bisacCode": "FIC009020",
    "name": "FICTION / Fantasy / Epic",
    "editionCount": 4474
}

Genre Data API Response Fields

Field	Type	Description
`bisacCode`	string	BISAC subject code. Matches the `slug` in a book's `genres` list.
`name`	string	Full BISAC heading.
`editionCount`	integer	Number of editions in the catalog with this genre.