Skip to content

Get Analysis

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

Get AI analysis results for a transcript.

Args: job_id: The job identifier.

Returns: Summary, extracted entities (with per-entity confidence), topics, key quotes, project relevance, chunk count, and analysis wall-clock time in milliseconds.

Raises: HTTPException(404): No job exists with the given id, or no analysis row has been written yet (analysis never ran or failed before any data was persisted).

job_id
required
Job Id
string

Successful Response

YouTubeAnalysisResponse

AI analysis results for a transcript.

object
jobId
required
Jobid

Job identifier

string
videoId
required
Videoid

YouTube video ID

string
title
required
Title

Video title

string
summary
required
Summary

AI-generated summary

string
entities
Entities

Extracted entities

Array<object>
Entity

Extracted entity from content with type classification and confidence scoring.

Represents a named entity (person, place, organization, concept, etc.) extracted from analyzed content with confidence scoring and contextual information.

Fields:

  • name: Entity name or identifier as extracted from content
  • entity_type: Classification type (person, place, organization, concept, etc.)
  • confidence: Extraction confidence score from 0.0 to 1.0
  • context: Surrounding text context where entity was found

Usage: Used in perception and research responses to return extracted entities.

Integration:

  • WebpagePerceptionResponse: Entity list in perception results
  • ResearchResult: Entities extracted from research results
  • EnrichContentResponse: Additional entities from enrichment
object
name
required
Name

Entity name or identifier

string
entityType
required
Entitytype

Entity type (person, place, concept, etc.)

string
confidence
required
Confidence

Extraction confidence score

number
<= 1
context
Any of:
string
topics
Topics

Key topics

Array<string>
keyQuotes
Keyquotes

Notable quotes

Array<string>
relevanceToProject
Any of:
string
chunksStored
Chunksstored

ChromaDB chunks stored

integer
0
processingTimeMs
Processingtimems

Analysis time in ms

integer
0

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