Create Batch Manifest From RSS | SoferAi

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 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 and use the feed URL it returns.

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.

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

checksumstring

SHA256 checksum of the manifest

validation_errorslist of strings

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

next_offsetinteger

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

Errors

401

Authentication Error

429

Rate Limit Error

Create a standard-mode batch manifest from a podcast RSS feed.

Need to find the RSS URL for a podcast? Try the RSS.com Podcast RSS Feed Finder and use the feed URL it returns.

1	from soferai import SoferAI
2	from soferai.transcribe import BatchFileMetadata
3
4	client = SoferAI(
5	api_key="YOUR_TOKEN_HERE",
6	)
7
8	client.batch_transcribe.create_batch_file_from_rss(
9	rss_url="https://example.com/podcast/feed.xml",
10	limit=100,
11	offset=0,
12	metadata=BatchFileMetadata(
13	title="Weekly Parsha Podcast",
14	description="Imported from RSS",
15	),
16	)

1	{
2	"batch_file_id": "c3d4e5f6-a789-4012-bcde-f12345678901",
3	"item_count": 100,
4	"size_bytes": 8192,
5	"created_at": "2024-01-15T09:30:00Z",
6	"status": "VALID",
7	"offset": 0,
8	"limit": 100,
9	"has_more": true,
10	"next_offset": 100
11	}