audible-api-ts

A fully typed TypeScript client for the Audible API.

Authentication, library, wishlist, catalog search — 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`)
})

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 | | catalog(credentials, options) | Search catalog by category with sorting | | verify(credentials) | Check if credentials are valid |

See the full documentation for guides and API reference.

License

MIT