> ## 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. # Channel Lives > Get live streams and past streams from a YouTube channel. Can pass channelId or handle. **Credit Cost:** 1 credit per request 💳 **1 credit per request** ## OpenAPI ````yaml GET /v1/scrape/youtube/channel/lives 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/channel/lives: get: tags: - youtube summary: Channel Lives description: >- Get live streams and past streams from a YouTube channel. Can pass channelId or handle. **Credit Cost:** 1 credit per request operationId: youtube_Channel_Lives parameters: - name: channelId in: query description: YouTube channel ID required: false schema: type: string example: UCWsDFcIhY2DBi3GB5uykGXA - name: handle in: query description: YouTube channel handle required: false schema: type: string example: IShowSpeed - name: continuationToken in: query description: >- Continuation token to get more lives. Get 'continuationToken' from previous response. required: false schema: type: string responses: '200': description: >- Successful response containing channel live streams **Key Response Fields:** - `lives[].id`: YouTube video ID - `lives[].url`: Full URL to the live stream - `lives[].title`: Live stream title - `lives[].thumbnail`: Thumbnail image URL - `lives[].viewCountText`: Formatted view/waiting count (e.g. "54 waiting", "1.2M") - `lives[].viewCountInt`: Numeric view count - `lives[].publishedTimeText`: Human-readable publish or schedule time - `lives[].lengthText`: Duration label (e.g. "2:13:29" or "Upcoming") - `lives[].lengthSeconds`: Duration in seconds (null for upcoming streams) - `continuationToken`: Token to fetch the next page of live streams (null if no more pages) content: application/json: example: success: true data: success: true videos: {} channels: {} playlists: {} shorts: {} shelves: {} lives: '0': type: live id: B97EEG4ZMBM url: https://www.youtube.com/watch?v=B97EEG4ZMBM title: irl stream at World Cup Opening Game⚽️🌎 thumbnail: >- https://i.ytimg.com/vi/B97EEG4ZMBM/hqdefault.jpg?sqp=-oaymwEnCNACELwBSFryq4qpAxkIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB&rs=AOn4CLBlo8B8S6pFhgEPYAz5lmmMwJX9dw channel: id: null title: null handle: null thumbnail: null viewCountText: 54 waiting viewCountInt: 54 publishedTimeText: Scheduled for 6/12/26, 5:00 PM publishedTime: '2026-06-11T10:06:01.243Z' lengthText: Upcoming lengthSeconds: null badges: {} '1': type: live id: tALs77Qv7Jw url: https://www.youtube.com/watch?v=tALs77Qv7Jw title: >- WORLD TALENT SHOW🌎 LIVE NOW !!! (100k Giveaway) (Presented by CashApp) thumbnail: >- https://i.ytimg.com/vi/tALs77Qv7Jw/hqdefault.jpg?sqp=-oaymwFBCNACELwBSFryq4qpAzMIARUAAIhCGAHYAQHiAQoIGBACGAY4AUAB8AEB-AH-CYAC0AWKAgwIABABGHIgSig7MA8=&rs=AOn4CLD1zvfvjC6fsYetyoLDsCHaMQAhjw channel: id: null title: null handle: null thumbnail: null viewCountText: 1.2M viewCountInt: 1200000 publishedTimeText: Streamed 3d ago publishedTime: '2026-06-11T10:06:01.243Z' lengthText: '2:13:29' lengthSeconds: 8009 badges: {} continuationToken: >- 4qmFsgKdCxIYVUNXc0RGY0loWTJEQmkzR0I1dXlrR1hBGoALOGdhY0NCcVpDSEtXQ0RxVENBb2tObU15T0dJME9HUXRNREF3TUMweU1qY3dMVGxqWkRNdE5UZ3lOREk1WVRZMU5XWmpFdWdIUVZObFIwSjVkVUp1TTNoV1dXRk1jbUpHTkdGQ0xYQjBUbTE2UlVGMFJtUkVNSFJMYURabk1ESjViMmxqUTJod2NIRnJialJWY1RZMU0yNXNjMnd0WjNaM2IwSm1NR3BMYkhCRVMweGxaRmRTUTNFeFpHNDJjVkZsU0U1aGQyZDZjemROVWtJNVV6bFlZMkl3TlZoVFlrazNaamxvUzNscmEyRjVXRTkxTkRCQlMyeFRUekUwWVhwcFkwb3haSGxpVW1aRU5uUk5iVWt6YTAxdVZFOU9TRXQyUzNvM1REUnZTM1JxWjNWd09XcEpUbEJwZVhCNE4wZFZSMWhQWlVKNE0wNXdWRVJhZVVOaFN6WnhXWEphTTB4bVFsUkhVa0pEV0ZWblpUWlVTRGhvTm1wU1ZFVkJWVnBVZG10eFRVMDRNbWhHWjNsNU5FZEpOMWhpY1V0RlRtcEZiV2hLV0U5bU1YbE1URlZYZVVzeWR6UXpibUZoYWtWSmExRlhhbHBYV1dsT1oyVmFNVVJwUlhKZlVUUjBTR2d4UTNvMVoyRXhVa1YxVDNwcmFtWndXa0l3VTFrMVQxaENSRkJrYm5KRE9HRktXSE5JUVZCak1rUnBkVVpDVWxKNVowNDFNVXRqZUdOWlRFUjRXRFpLVUc5RlpEQXRabmhCV201R2VGaFNSVmRqVGxWRWRWaGtOMjkwZUhreVdGQlJUekYyZFhwM1QyZG1ZWE5SWVVFd2JVbERZV2hEZUZoc1IwZDJOMHhaTUV3ME5qZERZbDk2VmtwUFdYb3phRGh1YWpCRlJWOUtXbU10U3pVeGRHOVlaRkZDWHpSTVkxVnJXbFpSUzFSWFgzSllaRTFPYlhKeVJrYzRRMGRWU2toMVlXcFpaa1JCZW5aMlgwTkRWblpZZUdZM2NqSldURkF4TkMwNGVWbGtOMkZLZHpabVEzSlNiR3gxZGxkWmQwazBaM0ZTZFRGdlVEaExNRGN6U25CbFlUTlhiSFpJZGpjMVRUWlpNMjF1TVd0S1dsWjVWbVpRYkZaeFExWlhTVlF6V1VORVozQjJUMEZNTnpjdGRIYzJhR3hFVEc0NFJqRm9kV1l3Y0VSWlJHa3lOSGs0UlVJelR6ZzNhRFU1WWtKdVJrVXlXbWhaTkVOTE1GUlBjRTlMT1RSc2JIVktXVWxHVG1WUFkwcFRNakJGTFdZMFdFNDBlblZ1Y1ZaZmJqSndlalEzT0hONE5FSnRWbWxsUlVWTVowaFBTM1JpTVdKSmEzSktXRkZXTkVoeWJVNWtlWGhYUTJkSlNYVlJZbk4zVlhkRFdYaEVObFJ5YVhwcFUyTjFlVTVQYXpJeGJYSjRVMHBvWVY5dVVVMHdRak40WjNaUk0xOWlXWEV5VVZObmRHeHVZbEZFV2s1UWRUSXdXazVpWDNGWFQyaGhORk5DV25oeFlrVTRhbFkxTjA1U2JWaFNiRVpSWkROSFdFVnlRelV4Tkc1a2RsazRSMVJFWVVKbU0wVndUbkIxVjJsSlJtUmZkVTlvUW5sWGFXTTFWUzEwVW01bFkwSnhielpTWVc5TGJXVnhiSGhMY25wUGVWUkRjVXhIYTFSaGFYRTRkVzh0VHpCMU1pMXROR3B3TWs5bFQxQkhjVjlWWDBWTWF6RkxPVkpUVVMxcWJsOTVXRlEyVkhZMlYwcE1hRVJMUjFWaGJGSmZNVlJWTFZocVRERmpSVFZ6VkUxclRtSktlVU56U1hKUVJ6ZGhkMTlIVFd4MWQzTk5NekZLV2hnTQ%3D%3D credits_used: 1 endpoint: youtube/channel/lives '400': description: Bad Request - Missing channelId or handle content: application/json: schema: type: object properties: error: type: string example: Either channelId or handle is required '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 available: type: integer example: 0 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). ````