# Social Media Video to Text: TikTok, Instagram, X Transcripts (`aemon/video-to-text-for-ai`) Actor

Turn Instagram Reels, TikTok, X, Facebook and YouTube videos into LLM-ready transcripts with timestamps, on-screen text, SRT subtitles and metadata. Optional AI summary, hook and CTA analysis, and translation. 90+ languages. Pay only for successful videos.

- **URL**: https://apify.com/aemon/video-to-text-for-ai.md
- **Developed by:** [Aemon](https://apify.com/aemon) (community)
- **Categories:** AI, Videos, Social media
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.50 / 1,000 video transcripts

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Video to Text by Aemon: Reels and TikToks to text for AI](https://dev-to-uploads.s3.us-east-2.amazonaws.com/uploads/articles/wrpwb1lpmtrflwvphxpm.png)

### What does Video to Text do?

**Video to Text** turns Instagram Reels, TikTok, X (Twitter), Facebook and YouTube videos into clean, **LLM-ready transcripts**. Paste video links and get back the full text, timestamped segments, optional SRT/VTT subtitles, **the text shown on screen**, an **AI breakdown of the video** (summary, hook, key points, call to action) and the video's metadata (author, views, likes, publish date), ready for ChatGPT, Claude, RAG pipelines and AI agents.

One Actor for every platform: no need to run a different transcript scraper for each social network.

- 🎯 **Captions first, AI second**: if the platform already has captions in the spoken language, they are used directly. Otherwise the audio is transcribed with **Whisper large-v3-turbo**.
- 📝 **Reads on-screen text too**: captions, titles and list items burned into the video, perfect for Reels and TikToks that use music instead of speech.
- 🤖 **AI analysis**: a summary, the opening hook, key points, the call to action, topics, content type and sentiment for every video. Ideal for competitor and creator research.
- 🌍 **90+ languages**, detected automatically, plus optional **AI translation** of every transcript into 29 languages.
- 🔗 **Bulk input**: single videos, or the newest N videos from TikTok profiles, YouTube channels and playlists, with an optional **published after** date filter.
- 🧾 **Pay only for successful transcripts**: private, removed or silent videos are reported with a clear error code and are never charged.
- 🤖 **Built for AI agents**: predictable JSON that works out of the box with the Apify MCP server, LangChain, n8n, Make and Zapier.
- ⚡ **Fast and cheap**: $6 per 1,000 short videos, with no platform usage fees on top.

![Demo: paste video links, click Start and get transcripts with an AI breakdown of every video](https://dev-to-uploads.s3.us-east-2.amazonaws.com/uploads/articles/s5q823ahy3pqws4p7bt9.gif)

### Why choose Video to Text?

| | Video to Text | Typical alternatives |
|---|---|---|
| Platforms in one run | Instagram, TikTok, X, Facebook, YouTube, audio and video files, podcast feeds | Usually one platform per tool |
| Price for 1,000 short videos | **$6**, platform usage included | Often $10–$50 per 1,000, or per-minute pricing |
| Failed or private videos | **Free**, with a clear error code | Varies by tool |
| Speech **and** on-screen text | ✅ | Rarely both |
| AI summary, hook, key points & CTA | ✅ **$0.004** per video | Rarely offered, or many times the price |
| Translation into 29 languages | ✅ | Rarely offered |
| Ready for AI agents (MCP) | ✅ | Varies |

### What can you use video transcripts for?

- **Feed short-form video into AI**: RAG knowledge bases, chatbots, AI agents and LLM analysis
- **Competitor and creator research**: see which hooks, offers and calls to action are working on TikTok and Reels, with the AI analysis already done for you
- **Content repurposing**: turn videos into blog posts, newsletters, threads and SEO articles
- **Trend and brand monitoring** across TikTok, Instagram, X and Facebook
- **Subtitles** for your own videos in SRT or WebVTT
- **Podcast transcription** from an RSS feed or a direct MP3 link

### What data does it extract?

| Field | Example |
|---|---|
| `text` | Full transcript as one clean paragraph |
| `segments` | `[{ "start": 0.0, "end": 3.2, "text": "..." }]` |
| `srt` / `vtt` | Ready-to-use subtitle file (optional) |
| `onScreenText` | `["3 TIPS FOR BETTER SLEEP", "No screens 1 hour before bed"]` (optional) |
| `aiAnalysis` | `summary`, `hook`, `keyPoints`, `callToAction`, `topics`, `contentType`, `sentiment` (optional) |
| `translatedText` | The transcript translated into the language you pick (optional) |
| `language` | Spoken language: `auto` (default) detects it automatically, or pick one such as `en`, `es`, `de` |
| `transcriptSource` | `captions` (platform captions) or `whisper` (AI) |
| `platform` | `instagram`, `tiktok`, `x`, `facebook`, `youtube`, ... |
| `author`, `authorUrl` | Creator name and profile link |
| `caption`, `title` | Post caption or video title |
| `publishedAt`, `durationSec` | Publish date and length |
| `views`, `likes`, `comments`, `shares`, `saves` | Engagement, when the platform shows it |
| `hashtags`, `music` | Hashtags from the caption and the sound used (TikTok) |
| `hookText` | What is said in the first 5 seconds: the spoken hook |
| `thumbnail` | Thumbnail image URL |

### How to transcribe Instagram, TikTok and X videos

1. Click **Try for free** (or **Start**).
2. Paste one or more video URLs into **Video URLs**. You can mix platforms in one run.
3. Optional: set **Max videos per URL** and **Only videos published after** if you pasted a TikTok profile, YouTube channel or playlist.
4. Optional: turn on **Read on-screen text**, **AI analysis** or **Translate transcript to**.
5. Click **Start**. Each video becomes one row in the dataset.
6. Download the results as JSON, CSV or Excel, or get them through the API, webhooks or integrations.

### Ready-to-run examples

Each example opens a pre-filled setup that you can run in one click and save as your own task:

- [TikTok Transcript: TikTok Video to Text with Timestamps](https://apify.com/aemon/video-to-text-for-ai/examples/tiktok-transcript)
- [TikTok Profile Transcripts: All Videos from a Creator](https://apify.com/aemon/video-to-text-for-ai/examples/tiktok-profile-transcripts)
- [Instagram Reel Transcript: Reel to Text with Timestamps](https://apify.com/aemon/video-to-text-for-ai/examples/instagram-reel-transcript)
- [Facebook Reel Transcript: Facebook Video to Text](https://apify.com/aemon/video-to-text-for-ai/examples/facebook-reel-transcript)
- [X (Twitter) Video Transcript: Tweet Video to Text](https://apify.com/aemon/video-to-text-for-ai/examples/x-twitter-video-transcript)
- [YouTube Transcript: YouTube Videos and Shorts to Text](https://apify.com/aemon/video-to-text-for-ai/examples/youtube-video-transcript)
- [TikTok & Reels AI Analysis: Hook, Summary and CTA](https://apify.com/aemon/video-to-text-for-ai/examples/tiktok-reels-ai-video-analysis)
- [Reels & TikTok On-Screen Text: Read Text in Videos](https://apify.com/aemon/video-to-text-for-ai/examples/reels-tiktok-on-screen-text)
- [TikTok SRT Subtitles: Generate Captions from Videos](https://apify.com/aemon/video-to-text-for-ai/examples/tiktok-srt-subtitles)
- [Bulk Video Transcripts: TikTok, Instagram, X & Facebook](https://apify.com/aemon/video-to-text-for-ai/examples/bulk-video-transcripts)

### How much does it cost to transcribe videos?

You pay only for successful transcripts. Platform usage (compute and proxies) is included.

| Event | Price | Per 1,000 |
|---|---|---|
| Video transcript up to 2 minutes (Instagram, TikTok, X, Facebook and other sites) | $0.006 | $6 |
| YouTube video transcript up to 2 minutes | $0.02 | $20 |
| Each additional started minute of AI transcription | $0.003 | $3 |
| Each additional started minute of AI transcription for YouTube (only for YouTube videos without captions) | $0.008 | $8 |
| On-screen text (only when **Read on-screen text** is on) | $0.002 | $2 |
| AI analysis (only when **AI analysis** is on) | $0.004 | $4 |
| Translation, per started 1,000 words (only when **Translate transcript to** is set) | $0.003 | $3 per million words |

- A 45-second Reel costs **$0.006**. 1,000 Reels cost **$6**, **$8** with on-screen text, or **$12** with on-screen text and AI analysis.
- A 10-minute video transcribed by AI costs $0.006 + 8 × $0.003 = **$0.030**.
- Videos transcribed from the platform's own captions cost the base price only, whatever their length.
- Failed, private, removed, silent and skipped videos are **free**.
- If on-screen text, AI analysis or translation fails for a video, you still get the transcript and that add-on is not charged.
- YouTube is priced higher because it can only be accessed through premium residential proxies. Most YouTube videos have captions, so they cost the base price only.
- 💡 **Only need YouTube?** [YouTube Transcript Scraper](https://apify.com/aemon/youtube-transcript-scraper) reads YouTube captions for **$0.002 per video** (10× less), including Shorts, playlists and whole channels. Use Video to Text for YouTube videos without captions, which it transcribes with AI.

💡 **On the Apify free plan** ($5 of monthly credit) you can transcribe roughly **800 short videos every month** for free.

You can also set a **maximum cost per run** in the run options. The Actor stops cleanly when the limit is reached and never charges more.

### Input

```json
{
    "urls": [
        "https://www.instagram.com/reel/XXXXXXXXXXX/",
        "https://www.tiktok.com/@creator/video/1234567890123456789",
        "https://x.com/user/status/1234567890123456789"
    ],
    "maxVideosPerUrl": 1,
    "language": "auto",
    "extractOnScreenText": true,
    "aiAnalysis": true,
    "translateTo": "none",
    "includeSegments": true,
    "subtitleFormat": "srt"
}
```

| Field | Description |
|---|---|
| `urls` | Video links, TikTok profiles, YouTube channels and playlists, or podcast feed URLs |
| `maxVideosPerUrl` | How many of the newest videos to take from a profile, channel, playlist or feed (default 1) |
| `publishedAfter` | Optional `YYYY-MM-DD` date: older videos from profiles, channels and playlists are skipped for free |
| `language` | Spoken language: `auto` (default) or a 2-letter code such as `en`, `es`, `de` |
| `extractOnScreenText` | Also read the text shown in the video (default `false`, +$0.002 per video, not for YouTube) |
| `aiAnalysis` | Add an AI summary, hook, key points, call to action, topics, content type and sentiment (default `false`, +$0.004 per video) |
| `translateTo` | `none` (default) or a 2-letter language code to also get the transcript translated (+$0.003 per 1,000 words) |
| `preferPlatformCaptions` | Use the platform's own captions when available (default `true`) |
| `includeSegments` | Add timestamped segments (default `true`) |
| `subtitleFormat` | `none`, `srt` or `vtt` |
| `maxDurationMinutes` | Skip longer videos without charging (default 120) |
| `maxConcurrency` | Videos processed in parallel (default 4) |
| `proxyConfiguration` | Fallback proxy for platforms that block direct requests (always used for YouTube) |

### Output example

```json
{
    "status": "ok",
    "url": "https://www.tiktok.com/@creator/video/1234567890123456789",
    "platform": "tiktok",
    "videoId": "1234567890123456789",
    "title": "3 tips for better sleep",
    "caption": "Save this for tonight #sleep",
    "author": "creator",
    "authorUrl": "https://www.tiktok.com/@creator",
    "publishedAt": "2026-11-10T18:22:05.000Z",
    "durationSec": 47,
    "views": 125000,
    "likes": 8300,
    "comments": 214,
    "shares": 96,
    "saves": 1840,
    "hashtags": ["sleep"],
    "music": "original sound - creator",
    "language": "en",
    "transcriptSource": "whisper",
    "hasSpeech": true,
    "text": "Here are three things I changed to finally sleep better...",
    "hookText": "Here are three things I changed to finally sleep better.",
    "wordCount": 132,
    "segments": [
        { "start": 0.0, "end": 3.2, "text": "Here are three things I changed" }
    ],
    "onScreenText": ["3 TIPS FOR BETTER SLEEP", "No screens 1 hour before bed"],
    "aiAnalysis": {
        "summary": "A creator shares three habits that improved their sleep: no screens before bed, a cool room and a fixed wake-up time.",
        "hook": "Here are three things I changed to finally sleep better.",
        "keyPoints": ["No screens 1 hour before bed", "Keep the bedroom cool", "Wake up at the same time every day"],
        "callToAction": "Save this video for tonight.",
        "topics": ["sleep", "health", "habits"],
        "contentType": "tutorial",
        "sentiment": "positive"
    },
    "srt": "1\n00:00:00,000 --> 00:00:03,200\nHere are three things I changed\n"
}
```

Failed videos are returned as rows with `"status": "error"`, an `errorCode` (`PRIVATE`, `UNAVAILABLE`, `LOGIN_REQUIRED`, `UNSUPPORTED_URL`, `PROFILE_NOT_SUPPORTED`, `NO_AUDIO`, `TOO_LONG`...) and a readable `error` message, so you always know what happened to every link. They are not charged.

### Use it from code, AI agents and automations

#### JavaScript

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('aemon/video-to-text-for-ai').call({
    urls: ['https://www.tiktok.com/@creator/video/1234567890123456789'],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].text);
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("aemon/video-to-text-for-ai").call(
    run_input={"urls": ["https://www.instagram.com/reel/XXXXXXXXXXX/"]}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["text"])
```

#### AI agents (MCP)

This Actor works as a tool in any MCP client through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Add it to the MCP configuration of Claude Desktop, Claude Code, Cursor or VS Code, with your [Apify API token](https://docs.apify.com/platform/integrations/api#api-token):

```json
{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com?tools=aemon/video-to-text-for-ai",
            "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
        }
    }
}
```

Then ask your agent in plain words, for example: *"Transcribe the last 10 TikToks of @apifylife and tell me what topics they cover."* The agent passes the links and reads back plain JSON.

Agents without an Apify account can still use it: the Actor accepts [agentic payments](https://docs.apify.com/agents/payments), so an agent can run it and pay per run with x402 (USDC) or a Skyfire token instead of an API token.

#### No-code

Connect it to **Make, Zapier, n8n, Google Sheets, Slack** or a webhook from the **Integrations** tab, for example to transcribe every new video a creator posts.

#### n8n, Make and Zapier

One HTTP request runs the Actor and returns the results, so it fits into any automation tool without extra nodes:

```
POST https://api.apify.com/v2/acts/aemon~video-to-text-for-ai/run-sync-get-dataset-items?timeout=300
Authorization: Bearer YOUR_APIFY_TOKEN
Content-Type: application/json

{ "urls": ["https://www.tiktok.com/@creator"], "maxVideosPerUrl": 20, "aiAnalysis": true }
```

In **n8n** use an *HTTP Request* node with *Header Auth* credentials, in **Make** the *HTTP → Make a request* module, and in **Zapier** *Webhooks by Zapier → Custom Request*. Each video comes back as one item, ready to send to Google Sheets, Notion, Slack, email or a Telegram bot. The call waits up to 5 minutes, which is enough for 30 to 40 short videos per request.

Ready-made Make template with a guided setup: [Weekly TikTok competitor hooks to Google Sheets](https://www.make.com/en/integration/20352-weekly-tiktok-competitor-hooks-to-google-sheets-ai-analysis-via-apify?templatePublicId=20352).

#### Ask an AI assistant about this Actor

Open a ready-made question about this Actor in [ChatGPT](https://chatgpt.com/?q=Using%20the%20Apify%20Actor%20%22Video%20to%20Text%3A%20Instagram%2C%20TikTok%20%26%20X%20Transcripts%22%20\(https%3A%2F%2Fapify.com%2Faemon%2Fvideo-to-text-for-ai\)%2C%20show%20me%20how%20to%20transcribe%20TikToks%2C%20Instagram%20Reels%20and%20X%20videos%20and%20feed%20the%20text%20to%20an%20LLM.%20Include%20the%20input%20JSON%2C%20the%20output%20fields%20and%20how%20to%20run%20it%20through%20the%20API%2C%20the%20Apify%20MCP%20server%20or%20n8n.), [Claude](https://claude.ai/new?q=Using%20the%20Apify%20Actor%20%22Video%20to%20Text%3A%20Instagram%2C%20TikTok%20%26%20X%20Transcripts%22%20\(https%3A%2F%2Fapify.com%2Faemon%2Fvideo-to-text-for-ai\)%2C%20show%20me%20how%20to%20transcribe%20TikToks%2C%20Instagram%20Reels%20and%20X%20videos%20and%20feed%20the%20text%20to%20an%20LLM.%20Include%20the%20input%20JSON%2C%20the%20output%20fields%20and%20how%20to%20run%20it%20through%20the%20API%2C%20the%20Apify%20MCP%20server%20or%20n8n.) or [Perplexity](https://www.perplexity.ai/search?q=Using%20the%20Apify%20Actor%20%22Video%20to%20Text%3A%20Instagram%2C%20TikTok%20%26%20X%20Transcripts%22%20\(https%3A%2F%2Fapify.com%2Faemon%2Fvideo-to-text-for-ai\)%2C%20show%20me%20how%20to%20transcribe%20TikToks%2C%20Instagram%20Reels%20and%20X%20videos%20and%20feed%20the%20text%20to%20an%20LLM.%20Include%20the%20input%20JSON%2C%20the%20output%20fields%20and%20how%20to%20run%20it%20through%20the%20API%2C%20the%20Apify%20MCP%20server%20or%20n8n.).

### Get video URLs in bulk

Need transcripts for hundreds of videos? Collect the URLs first with these Actors and pass them in:

- [TikTok Scraper](https://apify.com/clockworks/tiktok-scraper): videos from TikTok profiles, hashtags and searches
- [Instagram Reel Scraper](https://apify.com/apify/instagram-reel-scraper): Reels from Instagram profiles (Instagram only lists a profile's posts to logged-in users, so paste the Reel links it finds)
- [Tweet Scraper](https://apify.com/apidojo/tweet-scraper): posts and videos from X
- [YouTube Scraper](https://apify.com/streamers/youtube-scraper): videos from YouTube channels and searches

TikTok profiles, YouTube channels and playlists can also be pasted directly: set **Max videos per URL** to the number of newest videos you want.

### Supported sites

Instagram (Reels and video posts), TikTok (videos and profiles), X/Twitter (posts with video), Facebook (public videos and Reels), YouTube (videos, Shorts, channels and playlists), SoundCloud, direct MP3/MP4/M4A/WAV/FLAC links and podcast RSS feeds. Many other sites supported by yt-dlp also work, but are not tested regularly; sites that require a login (such as Reddit) are not supported. For Spotify podcasts, use [Podcast to Text](https://apify.com/aemon/podcast-audio-to-text), which transcribes them from the show's public RSS feed.

🎙️ **Transcribing podcasts?** [Podcast to Text](https://apify.com/aemon/podcast-audio-to-text) takes Apple Podcasts links and RSS feeds, picks the newest episodes or everything after a date, and charges per minute of audio, which is cheaper for long episodes.

### Single-purpose editions

Only need one platform or one job? The same engine is available as focused Actors with simpler input and lower prices:

| Actor | Best for | Price |
|---|---|---|
| [Instagram Reels Transcript Scraper](https://apify.com/aemon/instagram-reels-transcript-scraper) | Reel transcripts, no login | $5 per 1,000 Reels |
| [TikTok Transcript Scraper](https://apify.com/aemon/tiktok-transcript-scraper) | TikTok videos and whole profiles | $5 per 1,000 videos |
| [TikTok & Reels Hook Analyzer](https://apify.com/aemon/tiktok-reels-hook-analyzer) | Hooks, summaries and calls to action of competitors' videos | about $0.012 per video |
| [Video On-Screen Text Extractor](https://apify.com/aemon/video-on-screen-text-extractor) | Text shown in videos (captions, titles, lists) | about $0.008 per video |
| [YouTube Transcript Scraper](https://apify.com/aemon/youtube-transcript-scraper) | YouTube videos, Shorts, playlists and channels with captions | $2 per 1,000 videos |

Video to Text stays the all-in-one option: every platform in one run, and AI transcription for videos without captions.

### FAQ

**Does it work with private videos?**
No. Only publicly available videos are supported. The Actor never logs in to any account.

**How accurate are the transcripts?**
Platform captions are used as-is. AI transcripts use Whisper large-v3-turbo, one of the most accurate open speech recognition models, and work well even with background music and accents.

**What about videos with only music and no speech?**
They are returned with `"hasSpeech": false` and an empty `text`, and the base price applies because the audio still has to be downloaded and analysed. Turn on **Read on-screen text** to also get the captions and titles shown in the video, which is often where the message of such videos is. Videos without any audio track are returned as `NO_AUDIO` errors and are free.

**How does on-screen text work?**
The Actor takes a few frames spread across the video and an AI vision model reads the overlaid text: captions, titles, list items and burned-in subtitles, in order of appearance and without duplicates. Usernames and platform watermarks are ignored. If reading fails for a video, the transcript is still delivered and on-screen text is not charged. It is not available for YouTube.

**What does the AI analysis return?**
For every video: a 1-3 sentence `summary`, the opening `hook`, 2-6 `keyPoints`, the `callToAction` (or `null`), `topics`, `contentType` (tutorial, review, promotion, story...) and `sentiment`. It uses the caption, the on-screen text and the transcript, so it also works for music-only videos when **Read on-screen text** is on. It is written in the language of the video.

**Can it translate transcripts?**
Yes. Pick a language in **Translate transcript to** and every row also gets `translatedText`. You pay $0.003 per started 1,000 words; transcripts already in that language are returned as they are and not charged.

**How long can videos be?**
Up to 10 hours. Long recordings are split and transcribed in parts automatically. Use `maxDurationMinutes` to skip long videos.

**Is it legal to transcribe videos?**
The Actor only processes publicly available content and does not store videos. You are responsible for how you use the transcripts, including copyright and the platforms' terms. If you are unsure, consult a lawyer.

### Support

Found a link that does not work, or need a feature? Open an issue in the **Issues** tab. Issues are answered within a day. If the Actor saves you time, a rating on the Reviews tab helps others find it.

Built and maintained by [Aemon](https://apify.com/aemon).

# Changelog

This Actor's version history is a separate document: https://apify.com/aemon/video-to-text-for-ai/changelog.md

# Actor input Schema

## `urls` (type: `array`):

Links to videos (Instagram Reels, TikTok, X/Twitter, Facebook, YouTube, direct MP3/MP4 files), TikTok profiles, YouTube channels and playlists, or podcast RSS feeds. You can mix platforms. Instagram profiles need a login, so paste Reel links instead.

## `maxVideosPerUrl` (type: `integer`):

For profiles, playlists, channels and podcast feeds: how many of the newest videos to transcribe. Single video URLs always produce one result.

## `publishedAfter` (type: `string`):

For profiles, channels and playlists: skip videos published before this date (YYYY-MM-DD). Skipped videos are free. Single video links are never filtered.

## `extractOnScreenText` (type: `boolean`):

Also read the text shown in the video itself: captions, titles, list items and burned-in subtitles. Great for Reels and TikToks that use music instead of speech. Not available for YouTube.

## `aiAnalysis` (type: `boolean`):

Adds an AI breakdown of each video: a short summary, the opening hook, key points, the call to action, topics, content type and sentiment. Great for competitor and creator research.

## `translateTo` (type: `string`):

Also returns the transcript translated into this language with AI. Charged per started 1,000 words; transcripts already in this language are returned as they are and not charged.

## `language` (type: `string`):

Language spoken in the videos. Auto-detect works for 90+ languages; pick a language only if detection gets it wrong. This is not a translation option.

## `preferPlatformCaptions` (type: `boolean`):

Use the platform's own captions (for example YouTube) when they exist in the spoken language. Faster; AI transcription is used as a fallback.

## `includeSegments` (type: `boolean`):

Add a list of segments with start and end times in seconds.

## `subtitleFormat` (type: `string`):

Also return the transcript as a ready-to-use subtitle file.

## `maxDurationMinutes` (type: `integer`):

Videos longer than this are skipped and not charged.

## `maxConcurrency` (type: `integer`):

How many videos are processed at the same time.

## `proxyConfiguration` (type: `object`):

Used as a fallback when a platform blocks a direct request, and always for YouTube. Residential proxies work best.

## Actor input object example

```json
{
  "urls": [
    "https://www.tiktok.com/@apifylife/video/7338085038258457889",
    "https://www.instagram.com/reel/DMflZnXOKUj"
  ],
  "maxVideosPerUrl": 1,
  "publishedAfter": "",
  "extractOnScreenText": false,
  "aiAnalysis": false,
  "translateTo": "none",
  "language": "auto",
  "preferPlatformCaptions": true,
  "includeSegments": true,
  "subtitleFormat": "none",
  "maxDurationMinutes": 120,
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `transcripts` (type: `string`):

Transcript, language, source and word count for every video.

## `metadata` (type: `string`):

Author, publish date, duration, views, likes, comments, shares, saves, music, hashtags and thumbnail for every video.

## `analysis` (type: `string`):

Summary, hook, key points, call to action and topics for every video (when AI analysis is on).

## `allFields` (type: `string`):

Complete items including timestamped segments and subtitles.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.tiktok.com/@apifylife/video/7338085038258457889",
        "https://www.instagram.com/reel/DMflZnXOKUj"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("aemon/video-to-text-for-ai").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": [
        "https://www.tiktok.com/@apifylife/video/7338085038258457889",
        "https://www.instagram.com/reel/DMflZnXOKUj",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("aemon/video-to-text-for-ai").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.tiktok.com/@apifylife/video/7338085038258457889",
    "https://www.instagram.com/reel/DMflZnXOKUj"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call aemon/video-to-text-for-ai --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aemon/video-to-text-for-ai"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/TsMw27QGqhpvAmWTL/builds/wWVLg41qm8Grt705d/openapi.json
