API ReferenceBatch Transcribe

Create Batch Manifest From RSS

Create a standard-mode batch manifest from a podcast RSS feed. The feed is fetched and parsed for podcast episode audio enclosures. Each episode with an audio enclosure becomes one manifest item with `audio_url`, title, and a stable `client_item_id`. The returned `batch_file_id` can be used in [Create Batch Transcription](/api-reference/batch-transcribe/create-batch-transcription) with `processing_mode: "standard"`. By default, this imports up to the standard batch manifest limit. Use `limit` to import fewer episodes. If the feed has more episodes than one manifest can hold, call this endpoint again with the previous response's `next_offset`. Need to find the RSS URL for a podcast? Try the [RSS.com Podcast RSS Feed Finder](https://rss.com/tools/find-my-feed/) and use the feed URL it returns.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
rss_urlstringRequired
Public RSS feed URL to fetch and parse for podcast episode audio enclosures.
limitintegerOptional
Optional maximum number of episodes to import. Defaults to the standard batch manifest limit.
offsetintegerOptional

Number of podcast episode audio enclosures to skip before importing. Use next_offset from the previous response to fetch the next page.

metadataobjectOptional
Optional title and description for this manifest. If omitted, the podcast title from the feed is used when available.

Response

This endpoint returns an object.
batch_file_idUUID

Use this ID when calling Create Batch Transcription with standard mode

item_countinteger
Number of audio sources imported into this manifest
size_bytesinteger
Size of the manifest in bytes
created_atdatetime
Upload timestamp
statusenum

Validation status. Wait for VALID before starting a batch.

Allowed values:
offsetinteger
Number of audio enclosures skipped before this import started
limitinteger
Maximum number of audio enclosures requested for this import
has_moreboolean
Whether the feed contains more audio enclosures after this page
checksumstringOptional
SHA256 checksum of the manifest
validation_errorslist of stringsOptional

If status is INVALID, lists what’s wrong with the manifest

next_offsetintegerOptional

Offset to pass to import the next page. Omitted when has_more is false.

Errors

401
Authentication Error
429
Rate Limit Error