{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube Transcript & Subtitles Scraper | $0.65 per 1,000",
    "description": "YouTube transcripts for $0.65 per 1,000: videos, Shorts, whole channels, playlists or search results. Clean text plus timestamps or SRT, in any caption language, with title, channel, views and length included free. Schedule it on channels to get only new videos.",
    "version": "0.1",
    "x-build-id": "vk76dGP7qOylJl9gW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/m_ctim~youtube-transcript-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-m_ctim-youtube-transcript-scraper",
        "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/m_ctim~youtube-transcript-scraper/runs": {
      "post": {
        "operationId": "runs-sync-m_ctim-youtube-transcript-scraper",
        "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/m_ctim~youtube-transcript-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-m_ctim-youtube-transcript-scraper",
        "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": {
          "videos": {
            "title": "Videos",
            "type": "array",
            "description": "YouTube video links or 11-character IDs: watch links, youtu.be, Shorts, live and embed links all work. Leave everything empty to run the example videos.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "channels": {
            "title": "Channels",
            "type": "array",
            "description": "Channel links, @handles or channel IDs (UC...). The newest videos of each channel are transcribed, newest first.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "channelContent": {
            "title": "Which uploads of a channel",
            "enum": [
              "videos",
              "shorts",
              "streams",
              "all"
            ],
            "type": "string",
            "description": "Regular videos, Shorts, past live streams, or all of them.",
            "default": "videos"
          },
          "maxVideosPerChannel": {
            "title": "Videos per channel",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many of each channel's newest uploads to transcribe (1 to 5,000).",
            "default": 10
          },
          "playlists": {
            "title": "Playlists",
            "type": "array",
            "description": "Playlist links (with list=...) or playlist IDs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxVideosPerPlaylist": {
            "title": "Videos per playlist",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many videos of each playlist to transcribe, in playlist order (1 to 5,000).",
            "default": 100
          },
          "searchQueries": {
            "title": "YouTube searches",
            "type": "array",
            "description": "Search terms, as you'd type them on YouTube. The top video results are transcribed.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxVideosPerSearch": {
            "title": "Videos per search",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many of the top results of each search to transcribe (1 to 500).",
            "default": 20
          },
          "language": {
            "title": "Caption language",
            "type": "string",
            "description": "Language code(s) to prefer, in order, e.g. \"en\" or \"es, en\". Regional versions match too (\"en\" matches en-US and en-GB).",
            "default": "en"
          },
          "fallbackToAnyLanguage": {
            "title": "Fall back to the video's own language",
            "type": "boolean",
            "description": "When a video has no captions in your language, return the captions it does have (usually its spoken language). Off: such videos get a free row listing the languages available.",
            "default": true
          },
          "preferManualCaptions": {
            "title": "Prefer captions written by people",
            "type": "boolean",
            "description": "When a video has both, use the uploader's own captions over YouTube's automatic ones. Off: use the automatic ones (closer to what was said, word for word).",
            "default": true
          },
          "includeTimestamps": {
            "title": "Include timestamps",
            "type": "boolean",
            "description": "Add a segments list: each caption line with its start time and duration in seconds.",
            "default": true
          },
          "includeSrt": {
            "title": "Include an SRT subtitle file",
            "type": "boolean",
            "description": "Add the captions as SRT text, ready to save as a .srt file.",
            "default": false
          },
          "onlyNew": {
            "title": "Only new videos (for scheduled runs)",
            "type": "boolean",
            "description": "Skip videos that earlier runs with this option already returned. Schedule it on channels to get transcripts of new uploads only. Skipped videos aren't charged.",
            "default": false
          },
          "seenListName": {
            "title": "Name of the \"already returned\" list",
            "type": "string",
            "description": "Give each monitor its own list (3 to 63 lowercase letters, digits and hyphens), e.g. \"ai-channels\". Empty: one shared list."
          },
          "maxVideos": {
            "title": "Most videos per run",
            "minimum": 1,
            "maximum": 20000,
            "type": "integer",
            "description": "A cap on how many videos one run transcribes (1 to 20,000), so a big channel or playlist can't run longer than you meant.",
            "default": 1000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}