> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt > Use this file to discover all available pages before exploring further. # Get Video Subtitles > Retrieve available subtitle metadata for a video including `vssId`, `lang`, `langCode`. Returns a 404 error if the video does not exist. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /youtube/subtitles/meta openapi: 3.1.0 info: version: 1.0.0 title: CreatorDB Headless API V3 description: '# CreatorDB Headless API V3' contact: name: CreatorDB url: https://www.creatordb.app email: support@creatordb.app license: url: http://www.apache.org/licenses/LICENSE-2.0.html name: Apache 2.0 servers: - url: https://apiv3.creatordb.app description: Production Environment (CreatorDB Headless API V3) security: - ApiKeyAuth: [] tags: - name: Brand description: Brand analysis endpoints including sponsor search and brand reports. - name: Facebook description: Facebook creator data endpoints with metrics and search capabilities. - name: General Operations description: >- General-purpose endpoints such as API status, content retrieval, and cross-platform operations. - name: Instagram description: >- Instagram creator data endpoints with metrics and advanced search capabilities. - name: Niches description: >- Niche-related endpoints for content category analysis and related searches. - name: Threads description: Threads creator data endpoints with basic metrics and historical data. - name: TikTok description: >- TikTok creator data endpoints with metrics and advanced search functionality. - name: Topic description: Topic-based analysis and reporting endpoints for content categorization. - name: YouTube description: >- YouTube creator data endpoints including basic metrics, historical data, and detailed analytics. paths: /youtube/subtitles/meta: get: tags: - YouTube summary: Get Video Subtitles description: >- Retrieve available subtitle metadata for a video including `vssId`, `lang`, `langCode`. Returns a 404 error if the video does not exist. operationId: getYoutubeSubtitleMeta parameters: - name: videoId in: query description: 'The unique YouTube video ID (length: 11 characters).' required: true schema: type: string minLength: 11 maxLength: 11 pattern: ^[a-zA-Z0-9_-]{11}$ examples: - icxrUIGoEg8 responses: '200': description: Metadata of YouTube subtitles returned successfully. content: application/json: schema: type: object properties: data: type: object properties: videoId: type: string description: The video ID. examples: - icxrUIGoEg8 channelId: type: string description: The channel ID. examples: - UCuAXFkgsw1L7xaCfnd5JJOw availableSubtitles: type: array items: type: object properties: vssId: type: string description: The subtitle language record code. examples: - a.en lang: type: string description: Full language name. examples: - English (Auto-generated) langCode: type: string description: >- The language code in **ISO 639-1** two-letter format. examples: - en required: - vssId - lang - langCode description: Available subtitle metadata. description: List of available subtitle languages with metadata. required: - videoId - channelId - availableSubtitles description: Subtitle metadata for the video. creditsUsed: type: integer description: Number of API credits consumed by this request. examples: - 1 creditsAvailable: type: integer description: Number of API credits remaining. examples: - -1 traceId: type: string description: Unique trace ID for each request. examples: - f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0 timestamp: type: integer description: >- Time the response was generated, represented as a Unix timestamp in milliseconds. examples: - 1750732453635 errorCode: type: string description: >- Error code returned if the request fails. Empty if the request is successful. examples: - '' errorDescription: type: string description: >- Description of the error. Empty if the request is successful. examples: - '' success: type: boolean description: '`true` if the request is successful.' examples: - true required: - data - traceId - timestamp - errorCode - errorDescription - success - creditsUsed - creditsAvailable description: >- YouTube Subtitle Meta API response - available subtitle metadata for a video examples: default: summary: Subtitle metadata for a video value: data: videoId: icxrUIGoEg8 channelId: UCuAXFkgsw1L7xaCfnd5JJOw availableSubtitles: - vssId: a.en lang: English (Auto-generated) langCode: en - vssId: .en lang: English langCode: en - vssId: .zh-Hant lang: Chinese (Traditional) langCode: zh-Hant creditsUsed: 1 creditsAvailable: -1 traceId: f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0 timestamp: 1750732453635 errorCode: '' errorDescription: '' success: true '400': description: Validation error. content: application/json: schema: type: object title: ValidationErrorResponse description: Parameter validation error response format. properties: success: type: boolean enum: - false error: type: string message: type: string timestamp: type: integer required: - success - error - message - timestamp examples: missing videoId: summary: Missing videoId value: success: false error: VALIDATION_ERROR message: 'Missing required field: ''videoId''.' timestamp: 1770099403116 invalid video id: summary: Invalid videoId format value: success: false error: VALIDATION_ERROR message: >- Invalid `videoId` format. The YouTube videoIds must be 11 characters. timestamp: 1770099403116 '429': description: Exceeded quota or rate limit. content: application/json: schema: type: object title: QuotaErrorResponse description: Quota error response format. properties: success: type: boolean enum: - false error: type: string message: type: string remainingPlanCredit: type: number required: - success - error - message - remainingPlanCredit examples: rate limit: summary: Rate limit exceeded value: success: false error: RATE_LIMIT_EXCEEDED message: Too many requests. Please try again later. quota exceeded: summary: Credit quota exceeded value: success: false error: QUOTA_EXCEEDED message: Not enough credits to complete this request. x-codeSamples: - lang: bash label: cURL source: > curl -X GET "https://apiv3.creatordb.app/youtube/subtitles/meta?videoId=icxrUIGoEg8" \ -H "api-key: " components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````