# Podcast Transcripts API .well-known API

**Canonical:** https://apis.io/apis/spoken-md/podcast-transcripts-api-well-known-api/  
**Provider:** spoken-md — https://apis.io/providers/spoken-md/  
**Base URL:** https://spoken.md  
**Documentation:** https://spoken.md/podcast-transcript-api

Podcast Transcripts API .well-known API is one of 2 APIs that [spoken-md](https://apis.io/providers/spoken-md/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

Podcast transcripts as clean markdown. Built for AI agents. Use the demo key `pt_demo` to try it free (demo episode only).

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/search` | Search podcast episodes |
| GET | `/podcasts/{podcastId}/episodes` | List a show's full back-catalog |
| POST | `/buy` | Purchase API credits |
| POST | `/top-up` | Top up credits for an existing API key |
| GET | `/balance` | Check credit balance and usage |
| GET | `/following` | List the shows you follow |
| PUT | `/following/{podcastId}` | Follow a show |
| DELETE | `/following/{podcastId}` | Stop following a show |
| GET | `/new` | What is new on the shows you follow |
| GET | `/transcripts/{episodeId}` | Get podcast episode transcript |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/spoken-md/openapi/_original/spoken-md-well-known-openapi.json
- **JSONSchema** — https://artifacts.apis.io/spoken-md/json-schema/spoken-md-follow-schema.json
- **JSONSchema** — https://artifacts.apis.io/spoken-md/json-schema/spoken-md-new-episode-schema.json
- **JSONSchema** — https://artifacts.apis.io/spoken-md/json-schema/spoken-md-search-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/spoken-md/json-schema/spoken-md-episode-ref-schema.json

## Other spoken-md APIs (1)

- [Podcast Transcripts API](https://apis.io/apis/spoken-md/podcast-transcripts-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/spoken-md/podcast-transcripts-api-well-known-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/spoken-md/.