Skip to content

Get Analysis

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

Get local 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

Local 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

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