One full episode

Editorial Markdown, transcript, alternate-language fields, and provenance. This is the correct route for bulk or automated content access — responses are CDN-cached with a configured shared-cache lifetime of 60 seconds and no stale-while-revalidate. Conditional-response validators are not guaranteed.

get/api/v1/episodes/{slug}

Request

Base URL: https://bidclub.ai
URL: https://bidclub.ai/api/v1/episodes/{slug}
Auth: none declared

Path parameters

slugstring required

Response

The episode record.

slugstring required

Stable public identifier.

show_idstring required

Foreign key into /api/v1/shows.

titlestring required

Complete canonical publisher title.

display_titlestring nullable

Feed-only compression of an overlength title; null when unneeded.

title_origstring nullable

Source-platform title when it differs.

dekstring nullable

One-line editorial standfirst.

lang'EN' | 'ZH' | 'null' nullable

Language of the primary editorial fields.

datestring nullable

Publication calendar date, YYYY-MM-DD.

published_atstring nullable

Exact publication timestamp (RFC 3339); null for date-only archives.

duration_minnumber nullable

Episode length in minutes.

source_urlstring nullable

source_labelstring nullable

rss_urlstring nullable

youtube_idstring nullable

youtube_urlstring nullable

chipsstring[]

Participant tags, each prefixed "person:" (e.g. "person:Jensen Huang").

tag_assetsstring[]

Zero to two closed asset taxonomy ids, primary first. Empty is valid even after classification.

tag_sectorsstring[]

Zero to two closed sector taxonomy ids, primary first. Empty is valid even after classification.

tag_focusstring[]

Zero to two closed editorial-focus taxonomy ids, primary first. Empty is valid even after classification.

tagging_status'pending' | 'classified' | 'failed' | 'skipped'

Classification state. Non-classified episodes have empty tag arrays; classified does not require a tag in every facet.

tagging_versionstring nullable

Taxonomy version used for classification; nonblank when tagging_status is classified, otherwise it may be null.

thumbnail_urlstring nullable

title_altstring nullable

Title in the alternate language (lang_alt).

display_title_altstring nullable

dek_altstring nullable

lang_alt'EN' | 'ZH' | 'null' nullable

Language of every *_alt field.

tldr_mdstring nullable

TL;DR bullets as Markdown.

digest_mdstring nullable

Structured digest as Markdown.

transcript_mdstring nullable

Full speaker-attributed transcript.

tldr_md_altstring nullable

digest_md_altstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.