{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube Transcript Scraper | Captions API | $2 per 1K",
    "description": "Get YouTube transcripts and captions of videos, Shorts, playlists and whole channels as clean text with timestamps. SRT/VTT subtitles, AI summaries and chapters, translation, video details. MCP-ready, no login, $0.002 per video, and videos without captions are free.",
    "version": "0.1",
    "x-build-id": "PWOFImpedfL45Kzdx"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/aemon~youtube-transcript-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-aemon-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/aemon~youtube-transcript-scraper/runs": {
      "post": {
        "operationId": "runs-sync-aemon-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/aemon~youtube-transcript-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-aemon-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": {
          "urls": {
            "title": "YouTube URLs",
            "type": "array",
            "description": "Links to YouTube videos, Shorts, playlists or channels (https://www.youtube.com/@handle), one per line. Video ids such as dQw4w9WgXcQ work too.",
            "items": {
              "type": "string",
              "pattern": "^(https?://)?(([a-z0-9-]+\\.)?(youtube\\.com|youtube-nocookie\\.com)/.+|youtu\\.be/.+)$|^[\\w-]{11}$"
            }
          },
          "searchQueries": {
            "title": "Search YouTube for",
            "type": "array",
            "description": "Optional search terms, one per line, for example \"n8n tutorial\". The top videos for each term are transcribed, as many as Videos per channel, playlist or search. Each page of search results (about 20 videos) costs $0.004.",
            "items": {
              "type": "string"
            }
          },
          "searchSort": {
            "title": "Search order",
            "enum": [
              "relevance",
              "newest"
            ],
            "type": "string",
            "description": "For search terms: the most relevant videos, or the newest ones first.",
            "default": "relevance"
          },
          "maxVideosPerChannel": {
            "title": "Videos per channel, playlist or search",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "For channel and playlist links: how many of the newest videos to transcribe. For search terms: how many of the top results. Single video links always give one result.",
            "default": 10
          },
          "listOnly": {
            "title": "Only list the videos (no transcripts)",
            "type": "boolean",
            "description": "Returns each video of the channels, playlists and searches with its title, length, views and age, without transcripts, for $0.0005 per video. Use it to pick videos first, then transcribe only the ones you need.",
            "default": false
          },
          "publishedAfter": {
            "title": "Only videos published after",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string",
            "description": "For channel links: only videos published after this date (YYYY-MM-DD), up to the 15 newest. Ideal for monitoring channels on a schedule.",
            "default": ""
          },
          "language": {
            "title": "Preferred caption language",
            "type": "string",
            "description": "Optional language code such as en, es or pt-BR. If the video has captions in this language they are used; otherwise you get the captions in the language spoken in the video.",
            "default": ""
          },
          "includeAutoCaptions": {
            "title": "Use automatic captions",
            "type": "boolean",
            "description": "Use the automatic (speech recognition) captions of YouTube when a video has no written captions. Turn off to get only captions written by the creator.",
            "default": true
          },
          "includeSegments": {
            "title": "Include timestamped segments",
            "type": "boolean",
            "description": "Add the transcript split into timestamped lines. Turn off for smaller rows when you only need the text.",
            "default": true
          },
          "subtitleFormat": {
            "title": "Subtitle file format",
            "enum": [
              "none",
              "srt",
              "vtt"
            ],
            "type": "string",
            "description": "Also return the transcript as a ready-to-use subtitle file.",
            "default": "none"
          },
          "aiSummary": {
            "title": "🤖 AI summary, chapters & key points (+$0.004 per video)",
            "type": "boolean",
            "description": "Adds an AI summary of each video: a short summary, key takeaways, timestamped chapters, topics, people mentioned, notable quotes and sponsors with their offers.",
            "default": false
          },
          "translateTo": {
            "title": "🌍 Translate transcript to (+$0.003 per 1,000 words)",
            "enum": [
              "none",
              "en",
              "es",
              "pt",
              "fr",
              "de",
              "it",
              "nl",
              "pl",
              "cs",
              "sk",
              "ru",
              "uk",
              "tr",
              "ar",
              "hi",
              "id",
              "vi",
              "th",
              "ja",
              "ko",
              "zh",
              "sv",
              "da",
              "no",
              "fi",
              "el",
              "he",
              "ro",
              "hu"
            ],
            "type": "string",
            "description": "Also returns the transcript translated into this language with AI. Charged per started 1,000 words (about 7 minutes of speech); transcripts already in this language are returned as they are and not charged.",
            "default": "none"
          },
          "maxConcurrency": {
            "title": "Parallel videos",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "How many videos are processed at the same time.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "YouTube blocks datacenter IPs, so residential proxies are used by default. Proxy traffic is included in the price.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "US"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}