> ## Documentation Index > Fetch the complete documentation index at: https://www.tella.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get video information > Returns detailed information about a video including chapters, transcript, and thumbnails ## OpenAPI ````yaml /openapi.json get /v1/videos/{id} openapi: 3.0.3 info: description: >- The Tella Public API allows you to programmatically access your videos and playlists, including transcripts, chapters, and thumbnails. ## Authentication All requests require a Bearer token in the Authorization header: ``` Authorization: Bearer tella_pk_xxxxx... ``` API keys can be generated in your Tella workspace settings. ## Rate Limiting The API is rate-limited to 100 requests per minute per organization. Rate limit information is returned in response headers: - `X-RateLimit-Limit`: Maximum requests per window - `X-RateLimit-Remaining`: Remaining requests in current window - `X-RateLimit-Reset`: Unix timestamp when the window resets title: Tella Public API version: 1.0.0 servers: - description: Production url: https://api.tella.com security: [] tags: - description: Video operations name: Videos - description: Sections of a video name: Clips - description: Playlist operations name: Playlists - description: Sidebar groups for organizing playlists name: Playlist Groups - description: Tags for categorizing and filtering videos name: Tags - description: Webhook endpoint management name: Webhooks paths: /v1/videos/{id}: get: tags: - Videos summary: Get video information description: >- Returns detailed information about a video including chapters, transcript, and thumbnails operationId: getVideo parameters: - description: Unique video identifier in: path name: id required: true schema: description: Unique video identifier example: vid_abc123def456 type: string responses: '200': content: application/json: schema: additionalProperties: false properties: video: $ref: '#/components/schemas/VideoDetail' required: - video type: object description: OK '400': content: application/json: example: error: code: bad_request doc_url: https://tella.tv/docs/api-reference/errors#bad-request message: The request was malformed or contained invalid parameters. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was malformed or contained invalid parameters. '401': content: application/json: example: error: code: unauthorized doc_url: https://tella.tv/docs/api-reference/errors#unauthorized message: Authentication is required. Provide a valid API key. schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication is required. Provide a valid API key. '403': content: application/json: example: error: code: forbidden doc_url: https://tella.tv/docs/api-reference/errors#forbidden message: You don't have permission to access this resource. schema: $ref: '#/components/schemas/ErrorResponse' description: You don't have permission to access this resource. '404': content: application/json: example: error: code: not_found doc_url: https://tella.tv/docs/api-reference/errors#not-found message: The requested resource was not found. schema: $ref: '#/components/schemas/ErrorResponse' description: The requested resource was not found. '422': content: application/json: example: error: code: unprocessable_entity doc_url: >- https://tella.tv/docs/api-reference/errors#unprocessable-entity message: The request was well-formed but contained semantic errors. schema: $ref: '#/components/schemas/ErrorResponse' description: The request was well-formed but contained semantic errors. '429': content: application/json: example: error: code: rate_limit_exceeded doc_url: >- https://tella.tv/docs/api-reference/errors#rate-limit-exceeded message: You have exceeded the rate limit. Please slow down. schema: $ref: '#/components/schemas/ErrorResponse' description: You have exceeded the rate limit. Please slow down. '500': content: application/json: example: error: code: internal_server_error doc_url: >- https://tella.tv/docs/api-reference/errors#internal-server-error message: An unexpected error occurred on the server. schema: $ref: '#/components/schemas/ErrorResponse' description: An unexpected error occurred on the server. security: - BearerAuth: [] components: schemas: VideoDetail: additionalProperties: false description: >- Detailed information about a video including chapters, transcript, and exports properties: aspectRatio: description: Video aspect ratio (e.g., '16:9', '9:16') example: '16:9' type: string chapters: description: Video chapters/sections items: $ref: '#/components/schemas/Chapter' type: array clipIds: description: >- Ordered IDs of the clips in the video. Use `/v1/videos/{id}/clips/{clipId}` to fetch each one. example: - cl_abc123 - cl_def456 items: type: string type: array createdAt: description: ISO 8601 datetime example: '2024-01-15T10:30:00.000Z' format: date-time type: string description: description: Video description example: Learn how to create and share your first video maxLength: 5000 type: string dimensions: additionalProperties: false description: Canvas size in pixels example: height: 1080 width: 1920 properties: height: type: number width: type: number required: - width - height type: object durationSeconds: description: Video duration in seconds example: 125.5 minimum: 0 type: number exports: description: Available exports and their status items: $ref: '#/components/schemas/ExportStatus' type: array id: description: Unique video identifier example: vid_abc123def456 type: string links: allOf: - $ref: '#/components/schemas/VideoLinks' description: Related URLs for the video name: description: Video title example: Getting Started with Tella maxLength: 255 minLength: 1 type: string playlistIds: description: IDs of playlists containing this video example: - pl_abc123 - pl_def456 items: type: string type: array settings: allOf: - $ref: '#/components/schemas/VideoSettings' thumbnails: allOf: - $ref: '#/components/schemas/Thumbnails' description: Available thumbnail URLs by format and resolution transcript: allOf: - $ref: '#/components/schemas/Transcript' updatedAt: description: ISO 8601 datetime example: '2024-01-15T14:45:00.000Z' format: date-time type: string views: description: Total view count example: 1234 maximum: 9007199254740991 minimum: 0 type: integer required: - id - name - description - views - aspectRatio - dimensions - createdAt - updatedAt - durationSeconds - chapters - transcript - thumbnails - exports - settings - links - playlistIds - clipIds type: object ErrorResponse: additionalProperties: false description: Standard error response format properties: error: additionalProperties: false description: Error details properties: code: description: Machine-readable error code enum: - bad_request - unauthorized - forbidden - not_found - unprocessable_entity - rate_limit_exceeded - internal_server_error example: not_found type: string doc_url: description: Link to documentation for this error example: https://tella.tv/docs/api-reference/errors#not-found format: uri type: string message: description: Human-readable error message example: The requested resource was not found. type: string required: - code - message - doc_url type: object required: - error type: object Chapter: additionalProperties: false description: A chapter/section within a video properties: description: description: Chapter description example: Overview of what we'll cover maxLength: 5000 type: string timestampSeconds: description: Chapter start time in seconds example: 0 minimum: 0 type: number title: description: Chapter title example: Introduction maxLength: 255 minLength: 1 type: string required: - title - description - timestampSeconds type: object ExportStatus: additionalProperties: false description: Status of a video export job properties: downloadUrl: description: Download URL when export is completed, null otherwise example: https://cdn.tella.tv/exports/vid_abc123/video.mp4 format: uri nullable: true type: string exportId: description: Unique identifier for the export job example: exp_abc123def456 type: string progress: description: Export progress percentage (0-100), null if not started example: 100 maximum: 100 minimum: 0 nullable: true type: number status: description: Current export status enum: - queued - running - completed - failed example: completed type: string updatedAt: description: ISO 8601 datetime of last status update example: '2024-01-15T15:00:00.000Z' format: date-time type: string required: - exportId - status - progress - downloadUrl - updatedAt type: object VideoLinks: additionalProperties: false description: URLs related to a video properties: embedPage: description: URL for embedding the video example: https://www.tella.tv/video/vid_abc123def456/embed format: uri type: string viewPage: description: URL to view the video on Tella example: https://www.tella.tv/video/vid_abc123def456/view format: uri type: string required: - viewPage - embedPage type: object VideoSettings: additionalProperties: false description: Video playback and access settings properties: allowedEmbedDomains: description: >- Restrict embedding to these domains only (Premium feature). Empty array allows all domains. example: - example.com - mysite.org items: type: string type: array captionsDefaultEnabled: description: Show subtitles/captions by default example: true type: boolean commentEmailsEnabled: description: Send email notifications for new comments example: false type: boolean commentsEnabled: description: Allow viewers to comment example: true type: boolean customThumbnailURL: description: Custom thumbnail image URL example: https://example.com/custom-thumbnail.jpg format: uri nullable: true type: string defaultPlaybackRate: description: Default playback speed (0.5-2.0). Viewers can still adjust. example: 1 maximum: 2 minimum: 0.5 type: number downloadsEnabled: description: Allow viewers to download the video example: true type: boolean linkScope: description: >- Access level: public (anyone with link), private (org members only), password (requires password), embedonly (only viewable when embedded) enum: - public - private - password - embedonly example: public type: string publishDateEnabled: description: Show publish date on video page example: true type: boolean rawDownloadsEnabled: description: Allow viewers to download raw source files example: false type: boolean searchEngineIndexingEnabled: description: Allow search engines to index the video page example: true type: boolean studioSound: description: >- Studio Sound (AI audio enhancement) master switch for the video. Individual clips can opt out via the clip's `studioSound` field. example: false type: boolean transcriptsEnabled: description: Show transcript panel to viewers example: true type: boolean viewCountEnabled: description: Show view count on video page example: true type: boolean required: - defaultPlaybackRate - captionsDefaultEnabled - transcriptsEnabled - publishDateEnabled - viewCountEnabled - commentsEnabled - commentEmailsEnabled - downloadsEnabled - rawDownloadsEnabled - linkScope - searchEngineIndexingEnabled - allowedEmbedDomains - customThumbnailURL - studioSound type: object Thumbnails: additionalProperties: false description: Video thumbnails organized by size, with format options for each properties: large: allOf: - $ref: '#/components/schemas/ThumbnailFormats' description: >- Large thumbnails (1280x720 landscape, 720x1280 portrait, 1080x1080 square) medium: allOf: - $ref: '#/components/schemas/ThumbnailFormats' description: >- Medium thumbnails with animated formats (640x360 landscape, 360x640 portrait, 640x640 square) small: allOf: - $ref: '#/components/schemas/ThumbnailFormats' description: >- Small thumbnails with animated formats (320x180 landscape, 180x320 portrait, 320x320 square) xl: allOf: - $ref: '#/components/schemas/ThumbnailFormats' description: >- Extra large thumbnails (1920x1080 landscape, 1080x1920 portrait, 1080x1080 square) type: object Transcript: additionalProperties: false description: Video transcript data properties: language: description: Detected language code (e.g., 'en', 'es') example: en nullable: true type: string sentences: description: Sentences with timestamps items: $ref: '#/components/schemas/Sentence' nullable: true type: array status: description: Transcript generation status enum: - ready - processing - failed example: ready type: string text: description: Full transcript text example: Hello and welcome to this tutorial... nullable: true type: string required: - status - language - text - sentences type: object ThumbnailFormats: additionalProperties: false description: Thumbnail URLs in various formats for a specific size properties: gif: description: Animated GIF thumbnail URL (medium and small sizes only) example: https://cdn.tella.tv/thumbnails/vid_abc123/640x360.gif format: uri type: string jpg: description: JPEG thumbnail URL example: https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.jpg format: uri type: string mp4: description: Animated MP4 thumbnail URL (medium and small sizes only) example: https://cdn.tella.tv/thumbnails/vid_abc123/640x360.mp4 format: uri type: string webp: description: WebP thumbnail URL example: https://cdn.tella.tv/thumbnails/vid_abc123/1920x1080.webp format: uri type: string type: object Sentence: additionalProperties: false description: A sentence from the transcript with timestamps properties: endSeconds: description: Sentence end time in seconds example: 2.3 minimum: 0 type: number startSeconds: description: Sentence start time in seconds example: 0.5 minimum: 0 type: number text: description: Sentence text example: Hello and welcome to this tutorial. type: string required: - text - startSeconds - endSeconds type: object securitySchemes: BearerAuth: description: API key obtained from your Tella account settings scheme: bearer type: http ````