YouTube Video Subtitles as Timed Lines (US, English)

omnial/youtube-timed-subtitles-us-english

Given a YouTube video ID, returns the video's subtitles as timed lines, fetched with a United States location and English language setting: each line's text with its start time, end time and duration in seconds, in order, plus the video title, the subtitles' original language code and the number of lines. Subtitles come in their original language; translation is not offered.

activeper callv1

Price

Up to $0.00819 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

YouTube

Data from YouTube.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/youtube-timed-subtitles-us-english" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/youtube-timed-subtitles-us-english" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/youtube-timed-subtitles-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/youtube-timed-subtitles-us-english", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.00819

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "video_id",
    "location_code",
    "language_code"
  ],
  "properties": {
    "video_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "The YouTube video ID: the 11-character code after v= in a watch link."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The language setting; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The location setting; only 2840 (the United States) is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "text": {
                  "type": "string",
                  "description": "The line's text; it may hold line breaks and sound cues."
                },
                "end_time": {
                  "type": "number",
                  "description": "When the line disappears, in seconds from the start."
                },
                "start_time": {
                  "type": "number",
                  "description": "When the line appears, in seconds from the start."
                },
                "duration_time": {
                  "type": "number",
                  "description": "How long the line is shown, in seconds."
                }
              }
            },
            "description": "The subtitle lines, in the order they appear in the video."
          },
          "title": {
            "type": "string",
            "description": "The video title."
          },
          "video_id": {
            "type": "string",
            "description": "The video ID, as sent."
          },
          "origin_language": {
            "type": "string",
            "description": "The language code of the subtitles' original language."
          },
          "subtitles_count": {
            "type": "number",
            "description": "The number of subtitle lines."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}