Skip to content

Get Transcript

GET
/api/agents/youtube/transcript/{job_id}

Get the full transcript with timestamped segments.

Args: job_id: The job identifier.

Returns: Full transcript text, timestamped segments, duration, word count, and which source produced the captions (manual/auto/whisper).

Raises: HTTPException(404): No job exists with the given id, or the transcript text has not been produced yet. HTTPException(409): The job is not yet in complete or analyzing status (transcription still in progress).

job_id
required
Job Id
string

Successful Response

YouTubeTranscriptResponse

Full transcript with timestamped segments.

object
jobId
required
Jobid

Job identifier

string
videoId
required
Videoid

YouTube video ID

string
title
required
Title

Video title

string
transcriptText
required
Transcripttext

Full transcript text

string
segments
Segments

Timestamped segments

Array<object>
TranscriptSegmentModel

Single timestamped transcript segment.

object
startTime
required
Starttime

Segment start time in seconds

number
endTime
required
Endtime

Segment end time in seconds

number
text
required
Text

Segment text content

string
durationSeconds
required
Durationseconds

Video duration in seconds

integer
wordCount
required
Wordcount

Total word count

integer
captionSource
required
Captionsource

Source of captions

string
Allowed values: manual auto whisper

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object