> ## 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. # Transcript > Returns the transcript from a TikTok video. Enable the AI fallback option to generate a transcript when one is not natively available — note this costs 10 credits instead of 1. **Credit Cost:** 1 credit (or 10 credits with AI fallback) 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/tiktok/transcript 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/tiktok/transcript: get: tags: - tiktok summary: Transcript description: >- Returns the transcript from a TikTok video. Enable the AI fallback option to generate a transcript when one is not natively available — note this costs 10 credits instead of 1. **Credit Cost:** 1 credit (or 10 credits with AI fallback) operationId: tiktok_Transcript parameters: - name: url in: query description: TikTok video URL required: true schema: type: string example: https://www.tiktok.com/@stoolpresidente/video/7499229683859426602 - name: language in: query description: >- Language of the transcript. 2 letter language code, ie 'en', 'es', 'fr', 'de', 'it', 'ja', 'ko', 'zh' required: false schema: type: string example: en - name: use_ai_as_fallback in: query description: >- Set to 'true' to use AI as a fallback to get the transcript if the transcript is not found. Adds 10 credits to the base cost. required: false schema: type: boolean example: false responses: '200': description: Successful response content: application/json: example: success: true data: id: '7499229683859426602' url: >- https://www.tiktok.com/@stoolpresidente/video/7499229683859426602 transcript: > WEBVTT 00:00:00.120 --> 00:00:01.840 Alright, pizza review time. 00:00:01.841 --> 00:00:03.761 Sal's Pizza Factory. Oh, 00:00:03.762 --> 00:00:05.721 it's Fucking Corn. We're in Charlotte. 00:00:05.722 --> 00:00:07.861 Alright man, any chance I can get a real quick picture? 00:00:07.920 --> 00:00:10.040 Shaq or Dwight Howard? I gotta pick one. 00:00:10.041 --> 00:00:10.801 Yeah, Shaq. 00:00:10.802 --> 00:00:12.161 Yeah, easy, right? 00:00:12.162 --> 00:00:14.081 We're still Jason Williams still with us? 00:00:14.082 --> 00:00:16.361 Yeah, he on the plane right over, 00:00:16.362 --> 00:00:18.401 out of the blue. Said the following. 00:00:18.402 --> 00:00:21.121 He would take Dwight Howard over Shaq at center. 00:00:21.122 --> 00:00:23.541 And does he lie about it? For the rest of his life. 00:00:23.560 --> 00:00:25.280 And would never admit to saying that. 00:00:25.281 --> 00:00:28.341 Listen, y'all seen him on his camera more more times than me. 00:00:28.520 --> 00:00:32.040 He's lying. This is an outrageous pizza. 00:00:32.041 --> 00:00:33.661 I don't even know that they cut it. 00:00:35.360 --> 00:00:36.580 Wow, very hot. 00:00:36.600 --> 00:00:37.820 All right, it is cut. 00:00:37.840 --> 00:00:39.920 That's a lava soup in the middle. 00:00:39.921 --> 00:00:42.481 It is going back and forth like crazy. 00:00:42.482 --> 00:00:45.321 You need some silverware. I really do want to let this cool 00:00:45.322 --> 00:00:46.921 so we can talk about you to White House. 00:00:46.922 --> 00:00:48.081 No, it's shut. 00:00:48.082 --> 00:00:49.521 Look. Hahaha. 00:00:49.522 --> 00:00:51.221 And. But then he said if it. 00:00:51.360 --> 00:00:53.540 If it. If he was starting five, 00:00:53.600 --> 00:00:54.880 you would take Shaq. Yeah, 00:00:54.881 --> 00:00:56.721 but Dwight Howard's the best center. 00:00:56.722 --> 00:01:00.221 Shaq is the most dominant center ever to play the game of basketball. 00:01:01.080 --> 00:01:02.400 Why would you take Drake out? 00:01:02.401 --> 00:01:03.681 Uh, defensive purposes. 00:01:03.682 --> 00:01:07.841 So you're like MAV GM. Get rid of Luka and get a defensive guy in there. 00:01:07.842 --> 00:01:09.721 Listen, I'm nothing like Nico 00:01:09.722 --> 00:01:11.401 and I've never GM the team in my life. 00:01:11.402 --> 00:01:12.601 And I'm guarantee I'm better. 00:01:12.602 --> 00:01:15.601 I'd never make that deal that Was the dumbest deal ever to be made. 00:01:15.602 --> 00:01:18.321 This tastes better than how sloppy it is. 00:01:18.322 --> 00:01:19.841 7 3. It's not bad at all, 00:01:19.842 --> 00:01:20.641 this. Actually, 00:01:20.880 --> 00:01:23.640 I'm not just saying it. This eats way better than it looks. 00:01:23.641 --> 00:01:24.761 I don't know whether it is. 00:01:24.762 --> 00:01:26.041 Hustle this out of the oven. 00:01:26.042 --> 00:01:26.761 All right. Do you want some? 00:01:26.762 --> 00:01:27.201 No, sir. 00:01:27.202 --> 00:01:28.761 All right. I'm gonna burn the roof of my mouth. 00:01:28.762 --> 00:01:29.995 Alright, that's gonna be a problem. credits_used: 1 endpoint: tiktok/transcript '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). ````