> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Video/Short Details > Get complete information about a video or short. To get transcripts, use the dedicated /v1/scrape/youtube/video/transcript endpoint. 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/youtube/video openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/youtube/video: get: tags: - youtube summary: Video/Short Details description: >- Get complete information about a video or short. To get transcripts, use the dedicated /v1/scrape/youtube/video/transcript endpoint. operationId: youtube_Video_Short_Details parameters: - name: url in: query description: YouTube video or short URL required: true schema: type: string - name: language in: query description: >- Preferred response language (mapped to Accept-Language header; not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc. required: false schema: type: string example: en responses: '200': description: >- Successful response **Key Response Fields:** - `data.id`: YouTube video ID - `data.title`: Video title - `data.description`: Video description (may be null for shorts) - `data.url`: Full YouTube video URL - `data.thumbnail`: Thumbnail image URL - `data.type`: Media type — `"video"` or `"short"` - `data.publishDate`: ISO timestamp of publication - `data.viewCountInt`: View count as integer - `data.likeCountInt`: Like count as integer - `data.commentCountInt`: Comment count as integer - `data.durationMs`: Duration in milliseconds - `data.durationFormatted`: Duration as formatted string (e.g., `"00:01:30"`) - `data.channel.id`: Channel ID of the creator - `data.channel.handle`: Creator's @handle - `data.genre`: Video genre/category - `data.keywords`: Associated keywords/tags content: application/json: example: success: true data: success: true id: zdO3THL0mRo thumbnail: https://img.youtube.com/vi/zdO3THL0mRo/maxresdefault.jpg url: https://www.youtube.com/watch?v=zdO3THL0mRo publishDate: '2026-02-08T11:50:51-08:00' type: video title: It’s Super Bowl Sunday… WHO YA GOT description: null commentCountText: '65' commentCountInt: 65 likeCountText: '1081' likeCountInt: 1081 viewCountText: 23,093 viewCountInt: 23093 publishDateText: Feb 8, 2026 collaborators: {} channel: id: UCxcTeAKWJca6XyJ37_ZoKIQ url: https://www.youtube.com/@ThePatMcAfeeShow handle: ThePatMcAfeeShow title: The Pat McAfee Show chapters: {} watchNextVideos: '0': id: 7iEFiS1yNlI title: >- FULL NFL Countdown | Darnold or Maye: Who takes title? - ESPN on Super Bowl LX: Seahawks vs Patriots thumbnail: >- https://i.ytimg.com/vi/7iEFiS1yNlI/hqdefault.jpg?sqp=-oaymwEmCKgBEF5IWvKriqkDGQgBFQAAiEIYAdgBAeIBCggYEAIYBjgBQAE=&rs=AOn4CLBdestUmDFwZKG1OmntSdWf7n0VAA channel: title: Gabriel Ferreira url: https://www.youtube.com/@gabferreira_yt handle: gabferreira_yt id: UC5bk70mGnmnIZQu1lZ9-vjA publishedTimeText: 7 hours ago publishedTime: '2026-02-08T22:56:03.666Z' publishDateText: 7 hours ago publishDate: '2026-02-08T22:56:03.666Z' viewCountText: 29K views viewCountInt: 29000 lengthText: '31:16' lengthInSeconds: 1876 videoUrl: https://www.youtube.com/watch?v=7iEFiS1yNlI keywords: {} genre: Sports durationMs: 90000 durationFormatted: '00:01:30' captionTracks: {} transcript: null transcript_only_text: null credits_used: 1 endpoint: youtube/video '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````