Public REST/JSON reference

Podcast Notes API

Turn a podcast episode (uploaded MP3/MP4/WAV, RSS-feed item, or direct URL) into a transcript, a topic timeline, and editor-grade show notes (Markdown + HTML). Export to your CMS, blog, or transcript provider. Free tier covers 2 episodes/month. Part of the Logic Igniter Content & Marketing bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/podcastnotes.json

Operations rendered

Response models rendered

GET/api/v1/podcastnotes/customers

List customers

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/podcastnotes/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CustomersResponse

Page of customers

401Error

Missing or invalid API key.

POST/api/v1/podcastnotes/customers

Provision a customer

Idempotent customer provision. Free tier limits the workspace to 2 episodes per month.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: CreateCustomerRequest

Sample JSON payload for evaluation.

{
  "email": "[email protected]",
  "name": "Example Inc."
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/podcastnotes/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","name":"Example Inc."}'

Responses

201Customer

Customer created or returned

400Error

Invalid email or missing name

401Error

Missing or invalid API key.

GET/api/v1/podcastnotes/customers/{id}

Get a customer by id

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/podcastnotes/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200Customer

Customer record

401Error

Missing or invalid API key.

404Error

Customer not found

PUT/api/v1/podcastnotes/customers/{id}

Update a customer

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request body (required)

Schema: UpdateCustomerRequest

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/podcastnotes/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

200Customer

Updated customer

400Error

Invalid update

401Error

Missing or invalid API key.

404Error

Customer not found

POST/api/v1/podcastnotes/feeds

Add an RSS feed

Subscribe to a podcast RSS feed. New episodes are queued for transcription automatically as the feed updates.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: AddFeedRequest

Sample JSON payload for evaluation.

{
  "feed_url": "https://example.com/podcast.rss",
  "podcast_name": "Example Podcast"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/podcastnotes/feeds" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"feed_url":"https://example.com/podcast.rss","podcast_name":"Example Podcast"}'

Responses

201Feed

Feed registered

400Error

Invalid or unreachable feed URL

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 2 episodes per month; paid plans unlock unlimited episodes, RSS auto-ingest, and custom show-note templates.

POST/api/v1/podcastnotes/episodes/fetch

Fetch a single episode by URL

Submit a single audio URL for transcription. Returns immediately with `status = QUEUED`; poll `GET /episodes` until `status = READY`.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: FetchRequest

Sample JSON payload for evaluation.

{
  "url": "https://example.com/episode-42.mp3",
  "title": "Episode 42 — Breaking down auth"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/podcastnotes/episodes/fetch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/episode-42.mp3","title":"Episode 42 — Breaking down auth"}'

Responses

201Episode

Episode queued

400Error

Missing URL or unsupported audio format

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 2 episodes per month; paid plans unlock unlimited episodes, RSS auto-ingest, and custom show-note templates.

GET/api/v1/podcastnotes/episodes

List episodes

Return the workspace's submitted episodes, paginated. Each carries a `status` reflecting the transcription pipeline (QUEUED → FETCHED → TRANSCRIBING → TRANSCRIBED → GENERATING → READY).

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/podcastnotes/episodes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200EpisodesResponse

Page of episodes

401Error

Missing or invalid API key.

GET/api/v1/podcastnotes/episodes/{episode_id}/notes

Get show notes for an episode

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`episode_id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/podcastnotes/episodes/:episode_id/notes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200ShowNotes

Show notes

401Error

Missing or invalid API key.

404Error

Notes not yet generated

POST/api/v1/podcastnotes/episodes/{episode_id}/notes

Generate show notes

Trigger show-notes generation for a transcribed episode. Defaults to the standard editor template; use `/notes/regenerate` to apply a different template after the fact.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`episode_id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/podcastnotes/episodes/:episode_id/notes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

201ShowNotes

Show notes generated

400Error

Episode not yet transcribed

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 2 episodes per month; paid plans unlock unlimited episodes, RSS auto-ingest, and custom show-note templates.

404Error

Episode not found

POST/api/v1/podcastnotes/episodes/{episode_id}/notes/regenerate

Regenerate show notes with a different template

Replace previously-generated show notes with a fresh render using a named template (e.g. `interview`, `summary`, `extended`).

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`episode_id`required	path	string (uuid)

Request body (required)

Schema: RegenerateRequest

Sample JSON payload for evaluation.

{
  "template": "interview"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/podcastnotes/episodes/:episode_id/notes/regenerate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"template":"interview"}'

Responses

200ShowNotes

Regenerated show notes

400Error

Unknown template name

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 2 episodes per month; paid plans unlock unlimited episodes, RSS auto-ingest, and custom show-note templates.

404Error

Episode not found

POST/api/v1/podcastnotes/episodes/{episode_id}/notes/export

Export show notes

Render show notes to a downloadable artifact in the requested `format` (e.g. `markdown`, `html`, `docx`, `pdf`). The `content` field returns base64-encoded bytes.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`episode_id`required	path	string (uuid)

Request body (required)

Schema: ExportRequest

Sample JSON payload for evaluation.

{
  "format": "markdown"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/podcastnotes/episodes/:episode_id/notes/export" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"format":"markdown"}'

Responses

200ExportResult

Export result

400Error

Unsupported format

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers 2 episodes per month; paid plans unlock unlimited episodes, RSS auto-ingest, and custom show-note templates.

404Error

Show notes not generated

GET/api/v1/podcastnotes/episodes/{episode_id}/transcript

Get the full transcript

Retrieve the segmented transcript for an episode. Each segment has start/end timestamps in seconds, the spoken text, and the speaker label assigned by the diarizer.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`episode_id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/podcastnotes/episodes/:episode_id/transcript" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200Transcript

Transcript

401Error

Missing or invalid API key.

404Error

Episode not yet transcribed

GET/api/v1/podcastnotes/episodes/{episode_id}/topics

Get the topic timeline

Retrieve the auto-segmented topic timeline for an episode — each entry covers a contiguous window with a title and short summary, suitable for chapter markers.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`episode_id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/podcastnotes/episodes/:episode_id/topics" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200TopicsResponse

Topic list

401Error

Missing or invalid API key.

404Error

Episode not yet transcribed

Data models

Error

Field	Type	Notes
`error`required	string

EpisodeStatus

AudioContentType

FetchRequest

Field	Type	Notes
`url`required	string (uri)
`title`	string

Episode

Field	Type	Notes
`id`	string (uuid)
`title`	string
`audio_url`	string (uri)
`duration_seconds`	integer
`status`	EpisodeStatus
`published_at`	string (date-time)

EpisodesResponse

Field	Type	Notes
`items`	array<Episode>
`next_page_token`	string
`total_count`	integer

AddFeedRequest

Field	Type	Notes
`feed_url`required	string (uri)
`podcast_name`	string

Feed

Field	Type	Notes
`id`	string (uuid)
`feed_url`	string (uri)
`podcast_name`	string

ShowNotes

Field	Type	Notes
`id`	string (uuid)
`episode_id`	string (uuid)
`content_markdown`	string
`content_html`	string
`template_used`	string
`generated_at`	string (date-time)

RegenerateRequest

Field	Type	Notes
`template`required	string

ExportRequest

Field	Type	Notes
`format`required	string

ExportResult

Field	Type	Notes
`id`	string (uuid)
`format`	string
`content`	string (byte)

TranscriptSegment

Field	Type	Notes
`start`	number (double)
`end`	number (double)
`text`	string
`speaker`	string

Transcript

Field	Type	Notes
`id`	string (uuid)
`episode_id`	string (uuid)
`segments`	array<TranscriptSegment>
`speaker_count`	integer
`word_count`	integer

Topic

Field	Type	Notes
`id`	string (uuid)
`title`	string
`start_time`	number (double)
`end_time`	number (double)
`summary`	string

TopicsResponse

Field	Type	Notes
`items`	array<Topic>

CreateCustomerRequest

Field	Type	Notes
`email`required	string (email)
`name`required	string

UpdateCustomerRequest

Field	Type	Notes
`email`	string (email)
`name`	string

Customer

Field	Type	Notes
`id`	string (uuid)
`email`	string (email)
`name`	string
`created_at`	string (date-time)

CustomersResponse

Field	Type	Notes
`items`	array<Customer>
`next_page_token`	string
`total_count`	integer