Skip to main content
POST
/
v1
/
video
/
transcript
Extract structured transcript segments
curl --request POST \
  --url https://api.stophy.dev/v1/video/transcript \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
'
{
  "requestedLanguageCode": "<string>",
  "selectedLanguageCode": "<string>",
  "fallbackUsed": false,
  "fallbackReason": null,
  "transcript": {
    "plainText": "<string>",
    "transcript": [
      {
        "start": 123,
        "duration": 123,
        "text": "<string>"
      }
    ]
  }
}
Use this endpoint to extract transcript data from a YouTube video as structured, timestamped segments. Designed for AI agents, the response is clean, predictable, and ready for downstream tasks like summarization, embedding, or semantic search.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
videoUrl
string
required
Example:

"https://www.youtube.com/watch?v=dQw4w9WgXcQ"

​
languageCode
string
Example:

"en"

Response

​
requestedLanguageCode
string | null
​
selectedLanguageCode
string | null
​
fallbackUsed
boolean | null
​
fallbackReason
string | null
​
transcript
object