{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube Transcript Scraper - Timestamps, No API Key or Login",
    "description": "YouTube transcript API with no YouTube API key or login. Get transcripts with timestamps from videos, channels or playlists, from manual or auto captions in any language, plus video details. Optional speech-to-text. $2 per 1,000 transcripts ($0.002 each). Failed videos are free.",
    "version": "0.1",
    "x-build-id": "sbGnIVMDF78QPS2aR"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tidytools~youtube-transcript/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tidytools-youtube-transcript",
        "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/tidytools~youtube-transcript/runs": {
      "post": {
        "operationId": "runs-sync-tidytools-youtube-transcript",
        "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/tidytools~youtube-transcript/run-sync": {
      "post": {
        "operationId": "run-sync-tidytools-youtube-transcript",
        "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": "Video URLs",
            "type": "array",
            "description": "YouTube video URLs (watch, youtu.be, Shorts, live replay, mobile, attribution_link) or 11-character video ids. One per line; a channel or playlist link pasted here is expanded too.",
            "items": {
              "type": "string"
            }
          },
          "channels": {
            "title": "Channels and playlists",
            "type": "array",
            "description": "Channel URLs or @handles (latest uploads first) and playlist URLs. Each one adds up to \"Max videos per channel or playlist\" videos.",
            "items": {
              "type": "string"
            }
          },
          "maxVideosPerSource": {
            "title": "Max videos per channel or playlist",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "How many of the latest videos to take from each channel or playlist.",
            "default": 20
          },
          "maxVideos": {
            "title": "Max videos in total",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Upper limit for the whole run (direct videos plus channels and playlists).",
            "default": 100
          },
          "languages": {
            "title": "Preferred languages",
            "type": "array",
            "description": "Caption languages in order of preference, as codes (en, es, zh-TW, ja). A manual caption track wins over an auto-generated one in the same language. Leave empty for the video's original spoken language. Each result shows the requested languages, the language returned and whether it matched exactly (e.g. zh-TW) or only the base language (e.g. zh-Hans for zh-TW). Videos with captions only in other languages are returned as \"language_mismatch\" (not charged).",
            "items": {
              "type": "string"
            }
          },
          "includeTimestamps": {
            "title": "Include timestamped segments",
            "type": "boolean",
            "description": "Add the \"segments\" list (start, duration, text) next to the plain transcript text.",
            "default": true
          },
          "subtitleFormats": {
            "title": "Download subtitle files",
            "type": "array",
            "description": "Optional SRT and/or WebVTT files for successful transcripts. Adds subtitleSrtUrl and/or subtitleVttUrl download links. Files are made even when timestamped segments are hidden. No extra charge.",
            "items": {
              "type": "string",
              "enum": [
                "srt",
                "vtt"
              ],
              "enumTitles": [
                "SRT (.srt)",
                "WebVTT (.vtt)"
              ]
            },
            "default": []
          },
          "compactTranscript": {
            "title": "Simple transcript fields (videoUrl and segment end times)",
            "type": "boolean",
            "description": "Use videoUrl and compact segments with start, end and text. The standard output shape remains the default.",
            "default": false
          },
          "includeAsr": {
            "title": "Transcribe videos without captions (speech-to-text)",
            "type": "boolean",
            "description": "For videos that have no caption track at all, download the audio and transcribe it with Whisper (large-v3-turbo). Charged per audio minute, only for transcripts returned; videos with no speech (music, ambience) are not charged. Off by default.",
            "default": false
          },
          "asrMaxMinutesPerVideo": {
            "title": "Max minutes per video (speech-to-text)",
            "minimum": 1,
            "maximum": 240,
            "type": "integer",
            "description": "Videos longer than this are not transcribed (listed with the reason, not charged).",
            "default": 30
          },
          "asrMaxMinutesTotal": {
            "title": "Max speech-to-text minutes per run",
            "minimum": 1,
            "maximum": 3000,
            "type": "integer",
            "description": "Upper limit of audio minutes transcribed in one run. Your maximum charge per run also limits it.",
            "default": 60
          },
          "ragChunks": {
            "title": "Add RAG chunks with timestamp links",
            "type": "boolean",
            "description": "Adds \"chunks\": the transcript cut into time windows (start, end, text) with a link that opens the video at that moment (&t=). Ready for embeddings and citations. No extra charge.",
            "default": false
          },
          "chunkSeconds": {
            "title": "Chunk length",
            "minimum": 15,
            "maximum": 600,
            "type": "integer",
            "description": "Target length of each RAG chunk. Segments are never split.",
            "default": 60
          },
          "notes": {
            "title": "Add video notes (Markdown)",
            "type": "boolean",
            "description": "Adds \"notesMarkdown\": title, channel, date, length and the transcript in 3-minute sections, each headed by a timestamp link. No extra charge (no AI summary).",
            "default": false
          },
          "onlyNewVideos": {
            "title": "Only new channel videos (for schedules)",
            "type": "boolean",
            "description": "Remembers which channel and playlist videos were already processed (per monitor name) and skips them in later runs, so a daily schedule returns only new uploads. Skipped videos are free. A Markdown digest of the run is saved as DIGEST in the key-value store.",
            "default": false
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Keeps separate \"already processed\" lists for different schedules.",
            "default": "default"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}