{
  "openapi": "3.0.1",
  "info": {
    "title": "YouTube Transcript Scraper & API · $0.50/1K",
    "description": "Get YouTube transcripts and captions in bulk from video, Shorts and live links: full text, timestamped lines, the language you pick from all available captions, plus title, channel, views and date. No API key, no login. $0.50 per 1,000 transcripts. JSON, CSV, Excel.",
    "version": "1.0",
    "x-build-id": "pyZc8rUpfloCeC5B5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/sones~youtube-transcript-scraper-lowcost/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-sones-youtube-transcript-scraper-lowcost",
        "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/sones~youtube-transcript-scraper-lowcost/runs": {
      "post": {
        "operationId": "runs-sync-sones-youtube-transcript-scraper-lowcost",
        "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/sones~youtube-transcript-scraper-lowcost/run-sync": {
      "post": {
        "operationId": "run-sync-sones-youtube-transcript-scraper-lowcost",
        "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 links or IDs",
            "minItems": 0,
            "maxItems": 10000,
            "type": "array",
            "description": "Public YouTube video URLs or 11-character IDs. Watch, youtu.be, Shorts, embed and archived live links work. One video is exported and charged once per run, even when another source lists it. Keep channel and playlist URLs in Channels and playlists. Provide at least one video or source.",
            "items": {
              "type": "string",
              "minLength": 1
            }
          },
          "channels": {
            "title": "Channels and playlists",
            "maxItems": 100,
            "type": "array",
            "description": "Channel URLs or @handles, and playlist URLs or PL IDs. Channels expand through the selected tabs; a URL naming /shorts or /streams uses that tab. Playlists retain YouTube's order. Sources share run-wide video deduplication with Videos. Empty by default.",
            "items": {
              "type": "string"
            }
          },
          "contentTypes": {
            "title": "Channel tabs",
            "uniqueItems": true,
            "type": "array",
            "description": "Channel tabs to read, in this order. Default videos. A channel URL naming a tab overrides this list. The source's video cap is shared across its selected tabs. This setting does not classify or filter playlist entries or explicit video links.",
            "items": {
              "type": "string",
              "enum": [
                "videos",
                "shorts",
                "streams"
              ]
            },
            "default": [
              "videos"
            ]
          },
          "language": {
            "title": "Preferred language",
            "type": "string",
            "description": "First-choice caption language code, such as en, es, de, pt-BR or ja. Default en. This legacy field always comes before Languages in the priority list. Prefer mode falls back when no requested language exists; Strict mode reports no_captions. It selects existing captions and does not translate them.",
            "default": "en"
          },
          "languages": {
            "title": "Other languages in priority order",
            "maxItems": 20,
            "type": "array",
            "description": "Additional caption language codes to try after Preferred language, in the order listed. Example [\"es\", \"fr\", \"de\"]. Regional variants match the same primary language. This selects native tracks; use Translate to for machine translation.",
            "items": {
              "type": "string"
            }
          },
          "captionType": {
            "title": "Caption type",
            "enum": [
              "any",
              "manual",
              "auto"
            ],
            "type": "string",
            "description": "Choose any captions, uploader-provided manual captions, or YouTube's automatically generated captions. Default any prefers manual captions within a requested language. If the chosen type has no matching track, no transcript row is exported or charged.",
            "default": "any"
          },
          "languageMode": {
            "title": "Language fallback",
            "enum": [
              "prefer",
              "strict"
            ],
            "type": "string",
            "description": "Prefer tries requested languages, then the best available track and reports the actual language. Strict accepts only requested primary-language matches and otherwise reports no_captions with language_not_available. Strict still accepts regional variants such as en-GB for en.",
            "default": "prefer"
          },
          "allLanguages": {
            "title": "Download additional native tracks",
            "type": "boolean",
            "description": "Keep the selected primary transcript at the top level and download extra native tracks into tracks[]. maxTracks counts the primary plus these extra tracks. Default false. One delivered video has one item charge, regardless of track count.",
            "default": false
          },
          "maxTracks": {
            "title": "Maximum native tracks per video",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Maximum primary plus additional native caption tracks when Download additional native tracks is on. Default 5, range 1 to 10. Track refusals are marked track_unavailable and do not discard the primary transcript.",
            "default": 5
          },
          "listTracksOnly": {
            "title": "List tracks without downloading",
            "type": "boolean",
            "description": "Discover available caption tracks, with language codes, manual or auto type, IDs and default flags. Results go in RUN_SUMMARY.delivery.results[].availableTracks, not the charged dataset. No caption download or per-transcript charge. The run-start fee still applies.",
            "default": false
          },
          "translateTo": {
            "title": "Translate to",
            "maxItems": 3,
            "type": "array",
            "description": "Up to three target language codes for YouTube machine translation using tlang. The original stays in transcript; translations[] contains each target's text, segments, files and status. Refusals are translation_unavailable with empty translated text. Source-language targets are labelled source_language. No extra Actor charge. YouTube may throttle translation even when source captions work.",
            "items": {
              "type": "string"
            }
          },
          "outputFormats": {
            "title": "Transcript file formats",
            "uniqueItems": true,
            "type": "array",
            "description": "Generate requested text or subtitle contents in files.txt, files.srt, files.vtt, files.md and files.json. Default none. Delivered translations and extra native tracks have their own files. Large optional representations move to a JSON key-value-store record linked in artifacts. Formats do not add transcript charges.",
            "items": {
              "type": "string",
              "enum": [
                "txt",
                "srt",
                "vtt",
                "md",
                "json"
              ]
            },
            "default": []
          },
          "includeSegments": {
            "title": "Include raw timestamped segments",
            "type": "boolean",
            "description": "Include the original segments array beside transcript, with start and duration in seconds. Default true. Turn off to omit that array and keep the full text. Paragraphs, chunks and subtitle files retain their own timings.",
            "default": true
          },
          "chunkSize": {
            "title": "Approximate tokens per AI chunk",
            "minimum": 10,
            "maximum": 4000,
            "type": "integer",
            "description": "Set this field to enable chunks[]. Target defaults to 500 approximate tokens when only chunkOverlap is set. Range 10 to 4000. One token is estimated as four Unicode code points. Chunks keep complete words and graphemes; an oversized word can exceed the target. Citations use the first included caption line."
          },
          "chunkOverlap": {
            "title": "Approximate token overlap",
            "minimum": 0,
            "maximum": 3999,
            "type": "integer",
            "description": "Set this field or chunkSize to enable chunks[]. Target approximate tokens repeated between chunks, adjusted to complete words. Default 0. Must be smaller than chunkSize. Start times never decrease."
          },
          "keywords": {
            "title": "Keywords and phrases",
            "maxItems": 50,
            "type": "array",
            "description": "Case-insensitive literal keywords or phrases to find in the primary transcript. Matches may span adjacent caption lines. Each matches[] result has the matched caption text, start, end and a timestamped video URL. Maximum 50 keywords, 200 characters each. Empty by default.",
            "items": {
              "type": "string"
            }
          },
          "onlyVideosWithMatches": {
            "title": "Export only videos with keyword hits",
            "type": "boolean",
            "description": "Default false. When true, scan up to the source cap, export and charge only videos with at least one primary-transcript keyword hit. Other videos get filtered / no_keyword_matches in the delivery summary and have no item charge. Requires nonempty Keywords.",
            "default": false
          },
          "maxVideosPerSource": {
            "title": "Videos to scan per source",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Maximum considered videos per channel, playlist or search query, including duplicates, failures and filtered videos. Default 50. A channel shares its cap across selected tabs. Each search query has its own cap.",
            "default": 50
          },
          "publishedAfter": {
            "title": "Published after",
            "type": "string",
            "description": "Only deliver videos published strictly after this ISO date or timestamp, such as 2026-01-01 or 2026-01-01T12:00:00Z. Empty means no lower bound. A date alone means midnight UTC. Uses the exact publish date, not a rounded tile date. Applied within the source scan cap. Videos with no exact date are filtered when this bound is set."
          },
          "publishedBefore": {
            "title": "Published before",
            "type": "string",
            "description": "Only deliver videos published strictly before this ISO date or timestamp. Empty means no upper bound. A date alone means midnight UTC. Must be later than Published after. Uses exact metadata within the source scan cap; unknown dates are filtered."
          },
          "proxy": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Leave on automatic. To send every request through your own proxies instead, choose 'Own proxies' and enter their URLs."
          },
          "searchQueries": {
            "title": "Search queries",
            "maxItems": 1000,
            "type": "array",
            "description": "Keywords to search on YouTube, one query per entry. Each distinct query has its own maxVideosPerSource scan cap. Can be used without videos or channels. Results are public videos and Shorts, not channel or playlist search records.",
            "items": {
              "type": "string"
            }
          },
          "uploadDate": {
            "title": "Search upload date",
            "enum": [
              "hour",
              "today",
              "week",
              "month",
              "year"
            ],
            "type": "string",
            "description": "YouTube narrows discovery with this filter. The Actor also enforces the window locally from tile or player dates. hour, today, week, month and year mean the last hour, 24 hours, 7 days, 30 days and 365 days. Videos without a usable date are excluded. Omit for any time."
          },
          "searchType": {
            "title": "Search result type",
            "enum": [
              "videos",
              "shorts"
            ],
            "type": "string",
            "description": "Limit search results to videos or Shorts. Omit to keep both. Use the live feature to search for live streams."
          },
          "duration": {
            "title": "Search video duration",
            "enum": [
              "under3",
              "under4",
              "3to20",
              "4to20",
              "over20"
            ],
            "type": "string",
            "description": "YouTube's duration filter. Under 3 and 3 to 20 minutes match the current filter dialog; the older 4-minute options are also accepted."
          },
          "features": {
            "title": "Search features",
            "uniqueItems": true,
            "type": "array",
            "description": "YouTube feature filters, combined together. Location means a video with location metadata, not an uploader-country filter. Purchased content requires login and is not supported.",
            "items": {
              "type": "string",
              "enum": [
                "live",
                "4k",
                "hd",
                "subtitles",
                "creativeCommons",
                "360",
                "vr180",
                "3d",
                "hdr",
                "location"
              ],
              "enumTitles": [
                "Live now",
                "4K",
                "HD",
                "Subtitles",
                "Creative Commons",
                "360 degrees",
                "VR180",
                "3D",
                "HDR",
                "Has location"
              ]
            },
            "default": []
          },
          "searchSort": {
            "title": "Search order",
            "enum": [
              "relevance",
              "popularity"
            ],
            "type": "string",
            "description": "Relevance or YouTube's popularity ranking. Popularity is not a guaranteed numeric descending sort. YouTube ignored upload-date and rating sorts in the checked requests, so they are not offered.",
            "default": "relevance"
          },
          "searchLanguage": {
            "title": "Search language",
            "pattern": "^[a-z]{2,3}(?:-[A-Za-z0-9]{2,4})?$",
            "type": "string",
            "description": "YouTube hl language for search titles and interface text, such as en, de or pt-BR. Captions use language and languages separately."
          },
          "searchCountry": {
            "title": "Search country",
            "pattern": "^[A-Za-z]{2}$",
            "type": "string",
            "description": "YouTube gl locale, a two-letter country code such as US or DE. Changes search context. Does not restrict the uploader's country."
          },
          "onlyNewVideos": {
            "title": "Only new videos",
            "type": "boolean",
            "description": "Skip videos already delivered by earlier runs of this watchlist. Default false. The first run exports matching videos and records each one after its row is exported. Use schedules without overlapping runs. Overlap or a crash between export and recording can repeat a video.",
            "default": false
          },
          "watchlistName": {
            "title": "Watchlist store name",
            "pattern": "^[a-zA-Z0-9][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$",
            "type": "string",
            "description": "Optional persistent key-value store name in your Apify account. Use 3 to 63 letters, digits or hyphens, starting and ending with a letter or digit. With Only new videos on, an omitted field uses a hash of sources and output choices. Changing output choices selects a new default watchlist. An explicit name keeps the same history across input changes. Separate names also keep the two Actors independent."
          },
          "includeParagraphs": {
            "title": "Readable paragraphs",
            "type": "boolean",
            "description": "Add paragraphs[] with readable passages and caption-line timings. Default false. This does not change the legacy transcript or segments.",
            "default": false
          },
          "includeChapters": {
            "title": "Description chapters",
            "type": "boolean",
            "description": "Add chapters[] parsed from timestamps in the video description. Default false. Chapters are description metadata, not inferred from speech.",
            "default": false
          },
          "includeProvenance": {
            "title": "Source and caption provenance",
            "type": "boolean",
            "description": "Add source and provenance with the discovery association, language fallback and caption coverage. Default false. Caption coverage does not independently verify every spoken word.",
            "default": false
          },
          "includeAvailableTracks": {
            "title": "Available track details",
            "type": "boolean",
            "description": "Add availableTracks[] with native track IDs, language, type and default flags. Default false. For a summary without caption downloads or dataset rows, use listTracksOnly.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}