input | string | object | Input The podcast this record belongs to, as given. |
recordType | string | Record type episode = one episode (charged); transcript = one transcribed episode (charged per audio minute); summary = the show profile, one per podcast (free). e.g. "episode" |
position | integer | Position episode: 1-based position among the episodes delivered for the podcast (newest first). |
showTitle | string | null | Show The podcast's title. |
feedUrl | string | null | Feed URL The show's RSS feed (after redirects). |
appleId | string | null | Apple id The show's Apple Podcasts id, when it was looked up there. |
guid | string | null | GUID episode / transcript: the episode's GUID in the feed. |
title | string | null | Episode title episode: the episode's title. |
publishedAt | string | null | Published at episode / transcript: ISO 8601 publication time. |
durationSecs | number | null | Duration (s) episode: length in seconds as the feed states it; transcript: the audio length Mistral reports. |
duration | string | null | Duration episode: length as h:mm:ss. |
audioUrl | string | null | Audio URL episode / transcript: the audio file (the feed's enclosure). |
audioType | string | null | Audio type episode: MIME type of the audio file. |
audioSizeBytes | integer | null | Audio size episode: size of the audio file in bytes, as the feed states it. |
episodeNumber | integer | null | Episode number episode: itunes:episode (or podcast:episode). |
seasonNumber | integer | null | Season number episode: itunes:season (or podcast:season). |
episodeType | string | null | Episode type episode: full | trailer | bonus. |
explicit | boolean | null | Explicit Explicit content flag (an episode without its own flag inherits the show's). |
link | string | null | Episode page episode: the episode's web page. |
imageUrl | string | null | Image episode: the episode artwork; summary: the show artwork. |
description | string | null | Description episode: the show notes as plain text (at most 20,000 characters); summary: the show's description. |
links | array | null | Show-note links episode: the links in the show notes (at most 50). |
transcripts | array | null | Published transcripts episode: transcripts the show publishes itself (podcast:transcript) as [{ url, type, language }]. |
chaptersUrl | string | null | Chapters episode: the podcast:chapters file, when the show publishes one. |
people | array | null | People episode: hosts and guests the feed credits (podcast:person) as [{ name, role, group }]. |
appleEpisodeId | string | null | Apple episode id episode: Apple's episode id (only for episodes taken from Apple's directory). |
appleEpisodeUrl | string | null | Apple episode URL episode: the Apple Podcasts page of the episode (only for episodes taken from Apple's directory). |
episodeTitle | string | null | Episode title transcript: the transcribed episode's title. |
text | string | null | Transcript transcript: the transcribed text. |
segments | array | null | Segments transcript: timed segments [{ start, end, text, speaker }] (with timestamps). |
billedMinutes | integer | null | Billed minutes transcript: started minutes of audio charged (transcription-minute events). |
wordCount | integer | null | Words transcript: words of the transcript. |
model | string | null | Model transcript: the transcription model. |
podcast | string | null | Podcast summary: the podcast as given. |
resolvedVia | string | null | Resolved via summary: search | apple_id | feed_url | website. |
episodesSource | string | null | Episodes from summary: feed (the show's RSS feed) | apple (Apple's directory, when the show has no readable feed). |
author | string | null | Author summary: itunes:author, else Apple's artist name. |
ownerName | string | null | Owner name summary: itunes:owner name as published in the feed. |
ownerEmail | string | null | Owner e-mail summary: itunes:owner e-mail as published in the feed. |
language | string | null | Language summary: the feed's language; transcript: the detected spoken language. |
categories | array | null | Categories summary: iTunes categories ("Business > Investing"). |
appleGenres | array | null | Apple genres summary: Apple's genres for the show. |
showType | string | null | Show type summary: episodic | serial. |
complete | boolean | null | Complete summary: the show has ended (itunes:complete). |
website | string | null | Website summary: the show's website (the feed's link). |
newFeedUrl | string | null | New feed URL summary: the feed the show moved to (itunes:new-feed-url). |
copyright | string | null | Copyright summary: the feed's copyright line. |
podcastGuid | string | null | Podcast GUID summary: Podcasting 2.0 podcast:guid. |
fundingUrls | array | null | Funding links summary: podcast:funding links. |
appleUrl | string | null | Apple Podcasts URL summary: the show's Apple Podcasts page. |
appleEpisodeCount | integer | null | Apple episode count summary: episodes Apple lists for the show. |
episodesInFeed | integer | null | Episodes in feed summary: episodes the feed (or Apple) lists. |
firstEpisodeAt | string | null | First episode summary: date of the oldest listed episode. |
latestEpisodeAt | string | null | Latest episode summary: date of the newest episode. |
averageDurationSecs | integer | null | Average duration (s) summary: average episode length. |
medianIntervalDays | number | null | Release cadence (days) summary: median days between the latest 20 episodes. |
episodesLast30Days | integer | null | Episodes, last 30 days summary: episodes published in the last 30 days. |
episodesLast90Days | integer | null | Episodes, last 90 days summary: episodes published in the last 90 days. |
episodesOutsideDateWindow | integer | null | Episodes outside sinceDays summary: episodes left out by sinceDays (not charged). |
otherMatches | array | null | Other matches summary (name search): other Apple Podcasts matches [{ appleId, title, author, feedUrl, episodeCount }]; give one's appleId to read it instead. |
transcription | object | null | Transcription summary: { requested, delivered, minutesBilled, episodes: [{ guid, title, status, minutes?, reason? }] } when transcribeLatest is set on a paid plan. |
resultsDelivered | integer | null | Episodes delivered summary: episode rows delivered (and charged) for this podcast. |
stopReason | string | null | Stop reason summary: limit (maxEpisodesPerShow reached) | end (no more episodes) | budget | free_plan | aborted. |
status | string | Status ok | not_found | error | skipped_invalid | skipped_budget | skipped_free_plan | skipped_unmetered e.g. "ok" |
charged | boolean | Charged episode and transcript rows: true (charged before they were written); summary rows: false. |
chargedEvent | string | Charged event episode on episode rows; transcription-minute on transcript rows (billedMinutes events). |
chargedCount | integer | Events charged Events actually charged when a charge came back short (present only then). |
source | string | Source podcast: the show's RSS feed and Apple's podcast directory (transcripts by Mistral Voxtral). |
fetchedAt | string | Fetched at ISO timestamp. |
error | object | Error { code, message, provider?, status? } when status is not ok: invalid_input, podcast_not_found, not_a_feed, malformed_feed, not_found, http_error, rate_limit (Apple throttling), timeout, network, blocked_url; runtime codes: budget_exhausted, free_plan_limit, unmetered, aborted, charge_failed, record_too_large, invalid_record, dataset_push_failed. |
warnings | array | Warnings Notes about this record (caps, Apple fallback, transcripts not included and why). |
raw | object | null | Raw data episode: the parsed feed item; summary: Apple's show record (only with includeRaw). |