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

# Clip

> Get details of a Twitch clip.

**Credit Cost:** 1 credit per request

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


## OpenAPI

````yaml GET /v1/scrape/twitch/clip
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/twitch/clip:
    get:
      tags:
        - twitch
      summary: Clip
      description: |-
        Get details of a Twitch clip.

        **Credit Cost:** 1 credit per request
      operationId: twitch_Clip
      parameters:
        - name: url
          in: query
          description: Twitch clip URL
          required: true
          schema:
            type: string
            example: >-
              https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ?filter=clips&range=all&sort=time
      responses:
        '200':
          description: >-
            Successful response


            **Key Response Fields:**

            - `clip.id`: Clip ID

            - `clip.slug`: Clip slug identifier (used in URLs)

            - `clip.url`: Full clip URL on Twitch

            - `clip.embedURL`: Embeddable clip URL

            - `clip.title`: Clip title

            - `clip.viewCount`: Total view count

            - `clip.language`: Language code (e.g. "ES", "EN")

            - `clip.durationSeconds`: Clip length in seconds

            - `clip.createdAt`: ISO 8601 creation timestamp

            - `clip.thumbnailURL`: Clip thumbnail URL

            - `clip.isFeatured`: Whether the clip is featured

            - `clip.broadcaster.login`: Streamer's Twitch handle

            - `clip.broadcaster.displayName`: Streamer's display name

            - `clip.broadcaster.followers.totalCount`: Streamer's follower count

            - `clip.broadcaster.isPartner`: Whether the streamer is a Twitch
            Partner

            - `clip.game.name`: Game/category name

            - `clip.game.displayName`: Game display name

            - `clip.game.boxArtURL`: Game box art image URL

            - `clip.curator`: User who created the clip

            - `clip.videoQualities[].sourceURL`: Direct download URLs by quality

            - `clip.videoURL`: Direct video download URL (highest quality with
            auth token)
          content:
            application/json:
              example:
                success: true
                data:
                  '0':
                    data:
                      clip:
                        id: '387484507'
                        slug: CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ
                        url: >-
                          https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ
                        embedURL: >-
                          https://clips.twitch.tv/embed?clip=CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ
                        title: un grande el mesero
                        viewCount: 65820
                        language: ES
                        isFeatured: true
                        assets:
                          '0':
                            id: 4a27063d-e870-4963-bf40-c206f65a233c/LANDSCAPE
                            aspectRatio: 1.7777777777777777
                            type: SOURCE
                            createdAt: '2024-03-30T21:52:12.134391826Z'
                            creationState: CREATED
                            curator:
                              id: '192477639'
                              login: satagul_sy
                              displayName: Satagul_SY
                              profileImageURL: >-
                                https://static-cdn.jtvnw.net/jtv_user_pictures/a7d1cf0c-6482-475c-a7ba-9fedf75f0149-profile_image-50x50.png
                              __typename: User
                            thumbnailURL: >-
                              https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/4a27063d-e870-4963-bf40-c206f65a233c/landscape/thumb/thumb-0000000000-1920x1080.jpg
                            videoQualities:
                              '0':
                                frameRate: 0
                                quality: '1080'
                                sourceURL: >-
                                  https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/1080/index.mp4
                                __typename: ClipVideoQuality
                              '1':
                                frameRate: 0
                                quality: '720'
                                sourceURL: >-
                                  https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/720/index.mp4
                                __typename: ClipVideoQuality
                              '2':
                                frameRate: 0
                                quality: '480'
                                sourceURL: >-
                                  https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/480/index.mp4
                                __typename: ClipVideoQuality
                              '3':
                                frameRate: 0
                                quality: '360'
                                sourceURL: >-
                                  https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/360/index.mp4
                                __typename: ClipVideoQuality
                            portraitMetadata: null
                            __typename: ClipAsset
                        curator:
                          id: '192477639'
                          login: satagul_sy
                          displayName: Satagul_SY
                          profileImageURL: >-
                            https://static-cdn.jtvnw.net/jtv_user_pictures/a7d1cf0c-6482-475c-a7ba-9fedf75f0149-profile_image-70x70.png
                          __typename: User
                        game:
                          id: '509672'
                          name: IRL
                          boxArtURL: >-
                            https://static-cdn.jtvnw.net/ttv-boxart/509672-52x72.jpg
                          displayName: IRL
                          slug: irl
                          __typename: Game
                        broadcast:
                          id: '43930529883'
                          title: null
                          __typename: Broadcast
                        broadcaster:
                          id: '167189231'
                          login: staryuuki
                          displayName: Staryuuki
                          primaryColorHex: 689AFF
                          isPartner: true
                          profileImageURL: >-
                            https://static-cdn.jtvnw.net/jtv_user_pictures/fa589af4-5637-45f1-a179-d1cded652df8-profile_image-70x70.png
                          followers:
                            totalCount: 3543737
                            __typename: FollowerConnection
                          stream: null
                          lastBroadcast:
                            id: '319873941467'
                            startedAt: '2026-06-11T06:29:40.082294Z'
                            __typename: Broadcast
                          self: null
                          __typename: User
                        thumbnailURL: >-
                          https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/4a27063d-e870-4963-bf40-c206f65a233c/landscape/thumb/thumb-0000000000-1920x1080.jpg
                        createdAt: '2024-03-30T21:52:12Z'
                        isPublished: true
                        durationSeconds: 27
                        champBadge: null
                        playbackAccessToken:
                          signature: b9063d779b86da2f69894e8aa3a0ebc4a182ac7e
                          value: >-
                            {"authorization":{"forbidden":false,"reason":""},"clip_uri":"https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/360/index.mp4","clip_slug":"CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ","device_id":"gtd1TXg9937g0Ra59d6tJBe2f2vWobM7","expires":1781248088,"user_id":"","version":3}
                          __typename: PlaybackAccessToken
                        video: null
                        videoOffsetSeconds: null
                        videoQualities:
                          '0':
                            sourceURL: >-
                              https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/1080/index.mp4
                            __typename: ClipVideoQuality
                          '1':
                            sourceURL: >-
                              https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/720/index.mp4
                            __typename: ClipVideoQuality
                          '2':
                            sourceURL: >-
                              https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/480/index.mp4
                            __typename: ClipVideoQuality
                          '3':
                            sourceURL: >-
                              https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/360/index.mp4
                            __typename: ClipVideoQuality
                        isViewerEditRestricted: true
                        suggestedCropping: null
                        __typename: Clip
                        videoURL: >-
                          https://d1ndex63qxojbr.cloudfront.net/nauth/4a27063d-e870-4963-bf40-c206f65a233c/landscape/avc/1080/index.mp4?sig=b9063d779b86da2f69894e8aa3a0ebc4a182ac7e&token=%7B%22authorization%22%3A%7B%22forbidden%22%3Afalse%2C%22reason%22%3A%22%22%7D%2C%22clip_uri%22%3A%22https%3A%2F%2Fd1ndex63qxojbr.cloudfront.net%2Fnauth%2F4a27063d-e870-4963-bf40-c206f65a233c%2Flandscape%2Favc%2F360%2Findex.mp4%22%2C%22clip_slug%22%3A%22CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ%22%2C%22device_id%22%3A%22gtd1TXg9937g0Ra59d6tJBe2f2vWobM7%22%2C%22expires%22%3A1781248088%2C%22user_id%22%3A%22%22%2C%22version%22%3A3%7D
                    extensions:
                      durationMilliseconds: 76
                      operationName: ShareClipRenderStatus
                      requestID: 01KTV5WDYPKS3WHV9MK3D44A7D
                  '1':
                    data:
                      user:
                        id: '167189231'
                        clips:
                          pageInfo:
                            hasNextPage: true
                            __typename: PageInfo
                          edges:
                            '0':
                              cursor: null
                              node:
                                id: '2068359287'
                                slug: AmusedDiligentDelicataJKanStyle
                                url: >-
                                  https://www.twitch.tv/staryuuki/clip/AmusedDiligentDelicataJKanStyle
                                embedURL: >-
                                  https://clips.twitch.tv/embed?clip=AmusedDiligentDelicataJKanStyle
                                title: uff
                                viewCount: 164023
                                language: ES
                                curator:
                                  id: '106798576'
                                  login: 000pk
                                  displayName: 000pk
                                  __typename: User
                                game:
                                  id: '509658'
                                  slug: just-chatting
                                  name: Just Chatting
                                  boxArtURL: >-
                                    https://static-cdn.jtvnw.net/ttv-boxart/509658-52x72.jpg
                                  __typename: Game
                                broadcaster:
                                  id: '167189231'
                                  login: staryuuki
                                  displayName: Staryuuki
                                  profileImageURL: >-
                                    https://static-cdn.jtvnw.net/jtv_user_pictures/fa589af4-5637-45f1-a179-d1cded652df8-profile_image-50x50.png
                                  primaryColorHex: 689AFF
                                  roles:
                                    isPartner: true
                                    __typename: UserRoles
                                  __typename: User
                                thumbnailURL: >-
                                  https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/b7e5e556-7ae0-440e-b5cb-d39ef4700ec4/landscape/thumb/thumb-0000000000-704x400.jpg
                                createdAt: '2018-10-30T16:52:07Z'
                                durationSeconds: 29
                                champBadge: null
                                isFeatured: false
                                guestStarParticipants: null
                                __typename: Clip
                              __typename: ClipEdge
                            '1':
                              cursor: null
                              node:
                                id: '3014081212'
                                slug: LuckyTardyChinchillaCopyThis
                                url: >-
                                  https://www.twitch.tv/staryuuki/clip/LuckyTardyChinchillaCopyThis
                                embedURL: >-
                                  https://clips.twitch.tv/embed?clip=LuckyTardyChinchillaCopyThis
                                title: .
                                viewCount: 131571
                                language: ES
                                curator:
                                  id: '46575366'
                                  login: acegickmo
                                  displayName: Acegickmo
                                  __typename: User
                                game:
                                  id: '512927'
                                  slug: just-dance-2020
                                  name: Just Dance 2020
                                  boxArtURL: >-
                                    https://static-cdn.jtvnw.net/ttv-boxart/512927_IGDB-52x72.jpg
                                  __typename: Game
                                broadcaster:
                                  id: '167189231'
                                  login: staryuuki
                                  displayName: Staryuuki
                                  profileImageURL: >-
                                    https://static-cdn.jtvnw.net/jtv_user_pictures/fa589af4-5637-45f1-a179-d1cded652df8-profile_image-50x50.png
                                  primaryColorHex: 689AFF
                                  roles:
                                    isPartner: true
                                    __typename: UserRoles
                                  __typename: User
                                thumbnailURL: >-
                                  https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/1aecff99-8c24-424c-b5c7-9ece0ae9c6e6/landscape/thumb/thumb-0000000000-1920x1080.jpg
                                createdAt: '2020-11-08T02:30:27Z'
                                durationSeconds: 39
                                champBadge: null
                                isFeatured: false
                                guestStarParticipants: null
                                __typename: Clip
                              __typename: ClipEdge
                          __typename: ClipConnection
                        __typename: User
                    extensions:
                      durationMilliseconds: 98
                      operationName: ClipsCards__User
                      requestID: 01KTV5WDYPKS3WHV9MK3D44A7D
                  '2':
                    data:
                      user: null
                    extensions:
                      durationMilliseconds: 2
                      operationName: GetDisplayName
                      requestID: 01KTV5WDYPKS3WHV9MK3D44A7D
                  success: true
                credits_used: 1
                endpoint: twitch/clip
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Twitch clip URL is required
        '402':
          description: 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).

````