audible-api-ts

A fully typed TypeScript client for the Audible API.

Authentication, library, wishlist, catalog search and product lookup — all with complete type safety. The first maintained TypeScript alternative to mkb79/Audible (Python).

Documentation

Features

• Complete PKCE authentication — Same OAuth flow as the official Audible iOS app
• Signed API requests — RSA SHA256 request signing with device private key
• Library & wishlist — Fetch all audiobooks with automatic pagination
• Catalog search — Browse by category, sort by bestsellers or rating
• Full data — Ratings (overall/performance/story), categories, listening progress, series, cover images, and more
• 10 locales — US, UK, France, Germany, Italy, Spain, Canada, Australia, India, Japan
• Fully typed — Every function, response, and credential has TypeScript types

Install

bun add audible-api-ts
# or
npm install audible-api-ts

Requires Node.js 18+ (for native fetch and crypto).

Quick Start

import { login, register, library } from 'audible-api-ts'

// 1. Authenticate
const { loginUrl, session, cookies } = await login('com')
// → Redirect user to loginUrl (set cookies first)
const credentials = await register(authorizationCode, session)

// 2. Fetch library
const { items } = await library(credentials)

items.map((book) => {
  console.log(`${book.title} by ${book.authors.join(', ')}`)
  console.log(`  Rating: ${book.rating?.overallDistribution?.averageRating}/5`)
  console.log(`  Duration: ${Math.floor(book.durationMinutes / 60)}h${book.durationMinutes % 60}m`)
  if (book.series) console.log(`  Series: ${book.series.name} #${book.series.position}`)
  if (book.listeningStatus?.percentComplete) {
    console.log(`  Progress: ${book.listeningStatus.percentComplete}%`)
  }
})

Output:

Primal Hunter by Zogarth
  Rating: 4.8/5
  Duration: 29h30m
  Series: Primal Hunter #4
  Progress: 5%
Dune by Frank Herbert
  Rating: 4.7/5
  Duration: 18h0m

Catalog Search

Use genre names instead of opaque category IDs — the library resolves them per locale:

import { catalog } from 'audible-api-ts'

// Top Science Fiction by relevance (default sort)
const { items } = await catalog(credentials, {
  category: 'science-fiction',     // resolved per locale, no ID needed
  limit: 10,
})

// Or sort by release date, bestsellers, etc.
const { items: latest } = await catalog(credentials, {
  category: 'science-fiction',
  sortBy: 'ReleaseDate',
})

// ⚠️ MostVoted fetches ALL pages (up to 1000 items) then sorts client-side.
// Can take 10-60 seconds on large categories.
const { items: topVoted } = await catalog(credentials, {
  category: 'science-fiction',
  sortBy: 'MostVoted',
  limit: 10,
})

items.map((book) => {
  const r = book.rating?.overallDistribution
  console.log(`${book.title} — ${r?.numRatings} ratings, ${r?.averageRating?.toFixed(1)}/5`)
})

Search and Product Lookup

Search the whole catalog of the account's marketplace, without a category, or read one title by its ASIN — owned or not:

import { product, search } from 'audible-api-ts'

// Most relevant first; at least one of keywords, title, author or narrator
const { items } = await search(credentials, {
  title: 'Dungeon Crawler Carl',
  author: 'Matt Dinniman',
  limit: 20,
})
const third = items.find((book) => book.series?.position === 3)

// undefined when the marketplace does not sell that ASIN
const { item } = await product(credentials, 'B0934Y4DMW')

Output:

L'apprenti assassin — 4453 ratings, 4.8/5
Dune — 2112 ratings, 4.6/5
Projet Dernière chance — 832 ratings, 4.7/5

Available genres: 'science-fiction', 'fantasy', 'thriller', 'romance', 'horror', 'mystery', 'biography', 'history', 'business', 'comedy', and more. Sub-genres use slash notation: 'science-fiction/space-opera', 'fantasy/epic', 'thriller/psychological', 'romance/historical', etc.

API

Function	Description
login(locale)	Generate PKCE login URL + session + cookies
register(code, session)	Exchange auth code for credentials
refresh(credentials)	Manually refresh an access token (usually not needed — auto-refresh is built-in)
library(credentials)	Fetch all library audiobooks
wishlist(credentials)	Fetch all wishlist audiobooks
lastPositions(credentials, asins)	Where the reader last stopped in each title, the reliable progress signal
catalog(credentials, options)	Search catalog by category with sorting
search(credentials, options)	Search the whole catalog by title, author, narrator or keywords
product(credentials, asin)	Look one title up by its ASIN, owned or not
verify(credentials)	Check if credentials are valid

See the full documentation for guides and API reference.

License

MIT