> ## 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 Videos

> Get all videos from a channel with detailed information. Can pass channelId or handle.

<Note>
  💳 **1 credit** per request
</Note>


## OpenAPI

````yaml GET /v1/scrape/youtube/channel-videos
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-videos:
    get:
      tags:
        - youtube
      summary: Channel Videos
      description: >-
        Get all videos from a channel with detailed information. Can pass
        channelId or handle.
      operationId: youtube_Channel_Videos
      parameters:
        - name: channelId
          in: query
          description: YouTube channel ID
          required: false
          schema:
            type: string
            example: UC-9-kyTW8ZkZNDHQJ6FgpwQ
        - name: handle
          in: query
          description: YouTube channel handle
          required: false
          schema:
            type: string
            example: ThePatMcAfeeShow
        - name: sort
          in: query
          description: Sort by latest or popular
          required: false
          schema:
            type: string
            enum:
              - latest
              - popular
            example: latest
        - name: continuationToken
          in: query
          description: >-
            Continuation token to get more videos. Get 'continuationToken' from
            previous response.
          required: false
          schema:
            type: string
            example: 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB
      responses:
        '200':
          description: >-
            Successful response


            **Key Response Fields:**

            - `data.videos[0].id`: YouTube video ID

            - `data.videos[0].url`: Full YouTube video URL

            - `data.videos[0].title`: Video title

            - `data.videos[0].thumbnail`: Video thumbnail URL

            - `data.videos[0].viewCountInt`: View count as integer

            - `data.videos[0].publishedTime`: ISO timestamp of when the video
            was published

            - `data.videos[0].lengthSeconds`: Video duration in seconds

            - `data.continuationToken`: Pagination cursor — pass as
            `continuationToken` to get the next page
          content:
            application/json:
              example:
                success: true
                data:
                  success: true
                  videos:
                    '0':
                      type: video
                      id: lcBT7jDmfQQ
                      url: https://www.youtube.com/watch?v=lcBT7jDmfQQ
                      title: Puka Nacua Joins The Pat McAfee Show Live From Radio Row
                      thumbnail: >-
                        https://i.ytimg.com/vi/lcBT7jDmfQQ/hqdefault.jpg?sqp=-oaymwEjCNACELwBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBlBkXrD-5DJ5_lMOP_xTN0Q0WeWQ
                      channel:
                        title: ''
                        thumbnail: null
                      viewCountText: 35,488 views
                      viewCountInt: 35488
                      publishedTimeText: 1 day ago
                      publishedTime: '2026-02-07T22:51:12.745Z'
                      lengthText: '21:46'
                      lengthSeconds: 1306
                      badges: {}
                    '1':
                      type: video
                      id: Nb3CtVs0qwo
                      url: https://www.youtube.com/watch?v=Nb3CtVs0qwo
                      title: >-
                        National Champion & #1 Overall Pick Fernando Mendoza
                        Joins The Pat McAfee Show Live From Radio Row
                      thumbnail: >-
                        https://i.ytimg.com/vi/Nb3CtVs0qwo/hqdefault.jpg?sqp=-oaymwEjCNACELwBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLByPh11J4DW7cDlKoG2nJXxd7735w
                      channel:
                        title: ''
                        thumbnail: null
                      viewCountText: 147,931 views
                      viewCountInt: 147931
                      publishedTimeText: 1 day ago
                      publishedTime: '2026-02-07T22:51:12.745Z'
                      lengthText: '23:46'
                      lengthSeconds: 1426
                      badges: {}
                  channels: {}
                  playlists: {}
                  shorts: {}
                  shelves: {}
                  lives: {}
                  continuationToken: >-
                    4qmFsgKJERIYVUN4Y1RlQUtXSmNhNlh5SjM3X1pvS0lRGuwQOGdiSURCckZESHJDREFxY0JncnpCVUZtUjJKV01GTmljMVpOU3pkelgzcG5URlJVTFdVMWRtaEhibGh5V2xaRVNHdFVPSGRLT0VSeE5HYzNNVkZvWlRsVFQydHhaRTV3TW5OU2NtOWZUazUzVkZaVkxXaHpkVWxqVkdscFlUQmZXR3BVVUZkNWIydFNXUzFFTmpaamFsSlNUelZ5UjJkbFMyOXVabGd3UWsxS2RHTkpYMWwzZDJsbFUzZHFUamRqVUc1ak5WTXRUSFZDZUdac1dESTNZVmx5VTNwdmFFZzNaMlpEWDNWVVUyVkZYemg0VVd4V1RIbHZTbnBRWlhoNWFsUllkM1kyTFRsMFpFeHpabE5HY1dSc2EwWnlZM1ZaT1ZSTVVXTnBWMGh6YVVkQllrZDZaV0pYTTBwaU1WZ3lWVWR5UlhKRmNHYzJSemd3ZFhKaGIyMTJaRmxVTm1GSVNXNUZUREJzWlhsRFMzZFRiR0Y0ZFRjNFRtWkhVbmgyUWxObWFqTkpSSEJvYlVwcGVHTkVTbTVMTURrM2VrRkplV1oxTm14SFpHTndVRjlWWlhwUE1rVnFjME5vUzFOU1JuRjVkbll0VmxkalNVVmxNRFV4Ukd4YVMycEhUM0JtTVd3MVNWOWhORFpDWW5GNVpGaHVURXhYYTNCMVdYSkVRemxVY1ZkNFdYQTBaVEJaWXpWTmEyeGtOakpvWVhGSmMxRnNiR1oxWDFWeFdrNXFibU16ZG5ad1lscHRWM1I0TkhaNU5WWm1YMnBIYkhKZldWQTFRbVJIUmtkM2RWaDRiMnBGU0hwbkxUUXlUVTR4UmpKUVQwMUdVMWxYWmpsNFRXTmhWVFJyTVRkVldHdGFaR0ZqVldSTFp6RlJaVTU2TURJd1NqQklTVWQ1U1dKdGNrNWlNbXhaZGtwVGVrcE1iWEF6Tm5BM2QwRnpTemMwWmxscmNXNW1SVlJCYW1GdFRtTnlVV3RhY2xWb1VFMUpiazlwWlhScFQzcFRaekJzT1U4NWNtZEVTMEkzTTNWaVpEWmhNWHBTVWpVM2NEUklORTVLYTJsNWVIazNUV2g0Vm5BMGJYRTFPVTAzVUZwWExVVldlV2RRWkRndE4wSlpaRGd5WkRVM1h6VnNVMnMzWVRNNE1ucHBaVlp5UjFkbFkyVk1jWEoyWmpJMFYzWldOMk5pVm5sMWNWWTNUMWhFWW1aWExXOVhaR0V4VjBSVVNFMDJRelZLWkVaUU1ERlVkMXBZZGtGemVFTjZhekJOZEZSRGFtRlRSRFYyWkRKVldrUnNPV2xQVFhsSVRFNWxlbGRxT0dkWmQzTmlVRGRET0ZRNVVuY3hPVEZEZEVReGJVUkpFaVEyWWpKbE5HVTROQzB3TURBd0xUSmpNakl0WWpZd055MWtOR1kxTkRkbU9URXlaVGdnQkRxZUJnb2tObUl5WlRSbE9EUXRNREF3TUMweVl6SXlMV0kyTURjdFpEUm1OVFEzWmpreE1tVTRFdk1GUVdaSFlsWXdVMkp6VmsxTE4zTmZlbWRNVkZRdFpUVjJhRWR1V0hKYVZrUklhMVE0ZDBvNFJIRTBaemN4VVdobE9WTlBhM0ZrVG5BeWMxSnliMTlPVG5kVVZsVXRhSE4xU1dOVWFXbGhNRjlZYWxSUVYzbHZhMUpaTFVRMk5tTnFVbEpQTlhKSFoyVkxiMjVtV0RCQ1RVcDBZMGxmV1hkM2FXVlRkMnBPTjJOUWJtTTFVeTFNZFVKNFpteFlNamRoV1hKVGVtOW9TRGRuWmtOZmRWUlRaVVZmT0hoUmJGWk1lVzlLZWxCbGVIbHFWRmgzZGpZdE9YUmtUSE5tVTBaeFpHeHJSbkpqZFZrNVZFeFJZMmxYU0hOcFIwRmlSM3BsWWxjelNtSXhXREpWUjNKRmNrVndaelpIT0RCMWNtRnZiWFprV1ZRMllVaEpia1ZNTUd4bGVVTkxkMU5zWVhoMU56aE9aa2RTZUhaQ1UyWnFNMGxFY0dodFNtbDRZMFJLYmtzd09UZDZRVWw1Wm5VMmJFZGtZM0JRWDFWbGVrOHlSV3B6UTJoTFUxSkdjWGwyZGkxV1YyTkpSV1V3TlRGRWJGcExha2RQY0dZeGJEVkpYMkUwTmtKaWNYbGtXRzVNVEZkcmNIVlpja1JET1ZSeFYzaFpjRFJsTUZsak5VMXJiR1EyTW1oaGNVbHpVV3hzWm5WZlZYRmFUbXB1WXpOMmRuQmlXbTFYZEhnMGRuazFWbVpmYWtkc2NsOVpVRFZDWkVkR1IzZDFXSGh2YWtWSWVtY3ROREpOVGpGR01sQlBUVVpUV1ZkbU9YaE5ZMkZWTkdzeE4xVllhMXBrWVdOVlpFdG5NVkZsVG5vd01qQktNRWhKUjNsSlltMXlUbUl5YkZsMlNsTjZTa3h0Y0RNMmNEZDNRWE5MTnpSbVdXdHhibVpGVkVGcVlXMU9ZM0pSYTFweVZXaFFUVWx1VDJsbGRHbFBlbE5uTUd3NVR6bHlaMFJMUWpjemRXSmtObUV4ZWxKU05UZHdORWcwVGtwcmFYbDRlVGROYUhoV2NEUnRjVFU1VFRkUVdsY3RSVlo1WjFCa09DMDNRbGxrT0RKa05UZGZOV3hUYXpkaE16Z3llbWxsVm5KSFYyVmpaVXh4Y25abU1qUlhkbFkzWTJKV2VYVnhWamRQV0VSaVpsY3RiMWRrWVRGWFJGUklUVFpETlVwa1JsQXdNVlIzV2xoMlFYTjRRM3ByTUUxMFZFTnFZVk5FTlhaa01sVmFSR3c1YVU5TmVVaE1UbVY2VjJvNFoxbDNjMkpRTjBNNFZEbFNkekU1TVVOMFJERnRSRWtZQkElM0QlM0Q%3D
                credits_used: 1
                endpoint: youtube/channel-videos
        '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).

````