---
title: "What is new on the shows you follow"
method: GET
path: "/new"
---

# What is new on the shows you follow

`GET /new`

## Request

- Base URL: `https://spoken.md`
- URL: `https://spoken.md/new`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Every followed show (see /following) with the episodes released in the last 90 days that are newer than the newest episode you have fetched from it, up to the 10 newest per show, each with its transcript URL. Episodes with no transcript are left out. Reads a cache refreshed hourly; a show followed moments ago may list with no episodes until its first poll. Polling this route is free; fetching a transcript_url costs the normal credit. Send `Accept: application/atom+xml` or `?format=atom` for an Atom feed of the same episodes, which any feed reader or automation tool can subscribe to using HTTP Basic auth with the key as the username. Requires a real key, never cached.

## Query parameters

- `format` 'atom'

## Response `200`

New episodes, grouped by show

- object
  - `as_of` string, date-time, required
  - `count` integer, required: Episodes across all shows
  - `shows` object[], required
    - `podcast_id` string, required
    - `podcast` string, required
    - `source` 'fetch' | 'explicit', required
    - `episodes` NewEpisode[], required
      - `id` string, required: Episode ID
      - `title` string, required
      - `date` string, date-time, required: Release date
      - `transcript_url` string, required: GET it with your key to fetch the transcript: one credit on first fetch, free after that

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/spoken/apis/podcast-transcripts-api.md) · [All operations](https://skmtc.dev/spoken/apis/podcast-transcripts-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoken/apis/podcast-transcripts-api/revisions/3943c4c8211e?raw)