Captivate API Client

A Node.js client for interacting with the Captivate.fm API. Authenticate, upload media files, list shows and episodes, and create new podcast episodes using a simple, async-friendly interface.

---

🚀 Features

- 🔐 Authenticate using Captivate.fm API credentials
- 📤 Upload media files to your shows
- 🎙️ Create new podcast episodes
- 📺 List shows and episodes
- 🎨 Upload artwork
- ✅ Async/await-ready with clean API

---

📦 Installation

``bash
npm install captivate-fm-api-client
`

---

🔧 Requirements

- Node.js v14+
- Captivate.fm API access (user ID & API key)

---

🛠️ Usage

`js
const Captivate = require("captivate-api-client");

const captivate = new Captivate(
process.env.CAPTIVATE_USER_ID,
process.env.CAPTIVATE_API_KEY
);

(async () => {
await captivate.authenticateUser();

const shows = await captivate.getUserShows();
const showId = shows[0].id;

// Upload media file
const mediaId = await captivate.uploadEpisode("./episodes/my-ep.mp3", showId);

// Create an episode
const episode = await captivate.createEpisode({
showId,
title: "Episode Title",
mediaId,
showNotes: "This is the show notes content.",
publishDate: "2025-03-30",
summary: "Short summary of the episode.",
episodeType: "full",
episodeNumber: 5,
explicit: false,
});

console.log("Episode created:", episode);
})();
`

---

📚 API Reference

$3

Create a new client instance.

---

$3

Authenticates with Captivate using the provided credentials.

Returns: Promise

---

$3

Fetches the list of shows associated with the user.

Returns: Promise – array of show objects

---

$3

Fetches all episodes for a specific show.

- showId (string): The ID of the show

Returns: Promise