{
  "openapi": "3.0.1",
  "info": {
    "title": "Podcast Transcript API & Audio to Text | Transcribe Podcast",
    "description": "Extract podcast transcripts: transcribe podcast episodes from RSS feeds, Apple Podcasts links, pages or MP3 and video files at $4.50 per 1,000 audio minutes on every plan. Every podcast episode transcript has timestamps, language, SRT and details. Failed files are free.",
    "version": "0.1",
    "x-build-id": "DsuSbHUX5jtQW6M5X"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aurelix~podcast-transcript-audio-to-text/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aurelix-podcast-transcript-audio-to-text",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/aurelix~podcast-transcript-audio-to-text/runs": {
      "post": {
        "operationId": "runs-sync-aurelix-podcast-transcript-audio-to-text",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/aurelix~podcast-transcript-audio-to-text/run-sync": {
      "post": {
        "operationId": "run-sync-aurelix-podcast-transcript-audio-to-text",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "rssFeeds": {
            "title": "Podcast RSS feeds",
            "type": "array",
            "description": "Podcast RSS feed URLs or Apple Podcasts show links, e.g. ['https://feeds.npr.org/510289/podcast.xml', 'https://podcasts.apple.com/us/podcast/planet-money/id290783428']. The newest episodes are transcribed, up to 'Max episodes per feed'.",
            "items": {
              "type": "string"
            }
          },
          "audioUrls": {
            "title": "Audio, video or episode links",
            "type": "array",
            "description": "Direct audio or video file links (MP3, M4A, WAV, OGG, OPUS, FLAC, MP4, WEBM), episode web pages that embed a public audio file, or Apple Podcasts episode links, e.g. ['https://example.com/episode-12.mp3', 'https://podcasts.apple.com/us/podcast/x/id1200361736?i=1000650000000']. Only public, freely downloadable audio: no logins, DRM or YouTube/Spotify downloads.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxEpisodesPerFeed": {
            "title": "Max episodes per feed",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "How many of each feed's newest episodes to transcribe, e.g. 3. With 'Only new episodes' on, episodes returned by an earlier run are skipped and not counted.",
            "default": 1
          },
          "maxMinutesPerEpisode": {
            "title": "Max minutes per episode",
            "minimum": 1,
            "maximum": 600,
            "type": "integer",
            "description": "Transcribe at most this many minutes of each episode, e.g. 60 for the first hour. Longer episodes stop at the cap with status 'partial' and are billed only for the minutes transcribed.",
            "default": 240
          },
          "language": {
            "title": "Spoken language",
            "enum": [
              "auto",
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "nl",
              "pl",
              "ru",
              "uk",
              "tr",
              "ar",
              "hi",
              "ja",
              "ko",
              "zh",
              "id",
              "vi",
              "th",
              "sv",
              "no",
              "da",
              "fi",
              "cs",
              "ro",
              "hu",
              "el",
              "he",
              "fa",
              "ms",
              "tl",
              "ca"
            ],
            "type": "string",
            "description": "The language spoken in the audio. 'Detect automatically' detects it on every 2-minute chunk (so English ad breaks in a Spanish show stay Spanish) and reports the main one; setting it is slightly faster and avoids a wrong guess on music-heavy audio.",
            "default": "auto"
          },
          "translateToEnglish": {
            "title": "Translate to English",
            "type": "boolean",
            "description": "Return an English translation instead of the original-language transcript (same price per minute). Works best from widely spoken languages.",
            "default": false
          },
          "includeSegments": {
            "title": "Include timestamped segments",
            "type": "boolean",
            "description": "Add 'segments': every sentence-like segment with start and end in seconds, e.g. {start: 12.4, end: 17.9, text: '...'}. Off = plain text only, for smaller output.",
            "default": true
          },
          "includeWordTimestamps": {
            "title": "Include word timestamps",
            "type": "boolean",
            "description": "Add a start and end time for every word inside each segment, for karaoke-style captions or precise clipping. Makes transcription about 20% slower; the price per minute is the same.",
            "default": false
          },
          "includeSrt": {
            "title": "Include an SRT subtitle file",
            "type": "boolean",
            "description": "Add 'srt': the transcript as an SRT subtitle file in one text field, ready to save as .srt.",
            "default": false
          },
          "incremental": {
            "title": "Only new episodes since last run",
            "type": "boolean",
            "description": "Skip episodes an earlier run with the same inputs already transcribed, e.g. for a daily schedule on a few feeds so only new episodes are transcribed and billed.",
            "default": false
          },
          "stateKey": {
            "title": "Incremental state name (optional)",
            "type": "string",
            "description": "Name for the 'new since last run' memory, e.g. 'my-podcasts-daily'. Leave empty to derive it from the inputs."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL (optional)",
            "type": "string",
            "description": "After each run, post a short digest to Slack: how many episodes were transcribed and the top 10 with links, e.g. https://hooks.slack.com/services/T000/B000/XXXX. Nothing is posted when the run transcribed nothing. Leave empty to skip."
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "After each run, POST the same digest as JSON (actor, newOnly, count, items = top 10 results, runUrl, text) to any URL, e.g. a Zapier, Make or n8n webhook. Nothing is sent when the run transcribed nothing. Leave empty to skip."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}