# Video On-Screen Text Extractor (OCR) for Reels & TikTok (`aemon/video-on-screen-text-extractor`) Actor

Read the text shown in TikToks, Instagram Reels, X and Facebook videos: captions, titles, list items and burned-in subtitles, in order of appearance and without watermarks. Ideal for music-only videos. Includes the spoken transcript. About $0.008 per video.

- **URL**: https://apify.com/aemon/video-on-screen-text-extractor.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 On-Screen Text Extractor by Aemon](https://dev-to-uploads.s3.us-east-2.amazonaws.com/uploads/articles/joeyofptxj5tzdhfpkmj.png)

### What does Video On-Screen Text Extractor do?

**Video On-Screen Text Extractor** reads the text shown *inside* short videos: captions, titles, list items, prices and burned-in subtitles from **TikToks, Instagram Reels, X and Facebook videos**. It returns each distinct text in order of appearance, without usernames and platform watermarks, together with the spoken transcript. Many Reels and TikToks carry their whole message as text over music, and this is the way to get it out.

- 📝 **AI vision OCR**: frames are taken across the video and a vision model reads the overlaid text.
- 🧹 **Clean output**: duplicates, usernames and "TikTok"/"Instagram" watermarks are removed.
- 🎙️ **Spoken transcript included**, in 90+ languages.
- 🔓 **No login**: only public videos, no account needed.
- 💸 **About $0.008 per video** (transcript + on-screen text). If reading the text fails, that part is not charged.

### What you get

```json
{
    "url": "https://www.tiktok.com/@apifylife/video/7338085038258457889",
    "platform": "tiktok",
    "onScreenText": [
        "of course it took us half a year to get what we actually do",
        "of course we have the best office in the center of Prague",
        "of course you can work anytime",
        "we're Apify and we're hiring!"
    ],
    "text": "Hi, we're Appify. Of course it took us half a year to get what we actually do...",
    "hasSpeech": true,
    "durationSec": 32
}
```

Real output of the example run. The on-screen text even spells the brand correctly where the speech recognition heard "Appify".

### What can you use it for?

- **Music-only and text-only videos**: get the message that a plain transcript misses
- **Content research**: collect the on-screen hooks, lists and tips of top videos
- **Accessibility**: turn burned-in captions into real text
- **AI pipelines**: feed both the spoken words and the on-screen text to an LLM

### How to extract text from videos

1. Click **Try for free**.
2. Paste TikTok, Instagram Reel, X or Facebook video links.
3. Click **Start**. Each video becomes one row with `onScreenText` and the transcript.

### Ready-to-run examples

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

- [Extract Text from TikTok Videos: On-Screen Captions](https://apify.com/aemon/video-on-screen-text-extractor/examples/extract-text-from-tiktok-video): Read the text shown inside TikTok videos: captions, titles, list items and burned-in subtitles, in order of appearance and without the TikTok watermark, plus the spoken transcript.
- [Instagram Reel OCR: Extract Text Shown in Reels](https://apify.com/aemon/video-on-screen-text-extractor/examples/instagram-reel-ocr): Extract the text shown in Instagram Reels and video posts: captions, titles, lists and burned-in subtitles, in order of appearance and without watermarks, plus the spoken transcript.
- [Music-Only Video Text: Read Reels & TikToks Without Speech](https://apify.com/aemon/video-on-screen-text-extractor/examples/music-only-video-text): Many Reels and TikToks have no speech, only music and text on screen, so a normal transcript comes back empty.
- [X (Twitter) Video Text Extractor: On-Screen Text](https://apify.com/aemon/video-on-screen-text-extractor/examples/x-twitter-video-on-screen-text): Extract the text shown in videos posted on X (Twitter): captions, titles, chart labels and burned-in subtitles, in order of appearance, plus the spoken transcript and the post's details.
- [Facebook Reel Text Extractor: On-Screen Text & Transcript](https://apify.com/aemon/video-on-screen-text-extractor/examples/facebook-reel-on-screen-text): Extract the text shown in public Facebook Reels and videos: captions, titles, lists and burned-in subtitles, in order of appearance and without watermarks, plus the spoken transcript.

### Pricing

| Event | Price | Per 1,000 |
|---|---|---|
| Video transcript (up to 2 minutes) | $0.006 | $6 |
| On-screen text | $0.002 | $2 |
| AI analysis (optional) | $0.004 | $4 |
| Each additional minute of AI transcription | $0.003 | $3 |

A typical short video costs **$0.008**. Discounts apply on Apify Starter, Scale and Business plans. Failed, private and removed videos are never charged.

### Errors are free and explained

Every link you paste gets a row. If a video cannot be processed, the row has `"status": "error"`, an `errorCode` and a readable `error` message, and **it is not charged**:

| Error code | What it means |
|---|---|
| `PRIVATE` | The video or account is private. |
| `UNAVAILABLE` | The video was removed or does not exist. |
| `PROFILE_NOT_SUPPORTED` | An Instagram profile link: Instagram only lists profiles to logged-in users, so paste Reel links. |
| `PHOTO_POST_NOT_SUPPORTED` | A TikTok photo slideshow, which has no video. |
| `PLATFORM_NOT_SUPPORTED` | A link from a platform this Actor does not handle; the message names the Actor that does. |
| `NO_VIDEO` / `NO_AUDIO` | The post has no video, or the video has no audio track. |
| `TOO_LONG` | The video is longer than *Skip videos longer than*. |
| `LOGIN_REQUIRED` | The platform asked for a login (age restriction or bot check). |
| `RATE_LIMITED` / `BLOCKED` / `NETWORK` / `DOWNLOAD_FAILED` | A temporary problem. These are retried automatically up to 3 times first. |

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

#### Input example

```json
{
    "urls": [
        "https://www.tiktok.com/@apifylife/video/7338085038258457889"
    ],
    "extractOnScreenText": true
}
```

#### JavaScript

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('aemon/video-on-screen-text-extractor').call({"urls":["https://www.tiktok.com/@apifylife/video/7338085038258457889"],"extractOnScreenText":true});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("aemon/video-on-screen-text-extractor").call(run_input={"urls":["https://www.tiktok.com/@apifylife/video/7338085038258457889"],"extractOnScreenText":True})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

#### AI agents (MCP): Claude, ChatGPT, Cursor

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-on-screen-text-extractor",
            "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
        }
    }
}
```

Then ask your agent in plain words, for example: *"Read the text shown on screen in this TikTok and summarise it: https://www.tiktok.com/@apifylife/video/7338085038258457889"*

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.

#### n8n, Make and Zapier

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

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

{"urls":["https://www.tiktok.com/@apifylife/video/7338085038258457889"],"extractOnScreenText":true}
```

In **n8n** use an *HTTP Request* node, in **Make** *HTTP → Make a request* and in **Zapier** *Webhooks by Zapier → Custom Request*. Every video comes back as one item, ready for Google Sheets, Notion, Slack or email. You can also connect integrations and webhooks directly in the **Integrations** tab.

#### 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%20On-Screen%20Text%20Extractor%20\(OCR\)%20for%20Reels%20%26%20TikTok%22%20\(https%3A%2F%2Fapify.com%2Faemon%2Fvideo-on-screen-text-extractor\)%2C%20show%20me%20how%20to%20extract%20the%20text%20shown%20on%20screen%20in%20music-only%20Reels%20and%20TikToks.%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%20On-Screen%20Text%20Extractor%20\(OCR\)%20for%20Reels%20%26%20TikTok%22%20\(https%3A%2F%2Fapify.com%2Faemon%2Fvideo-on-screen-text-extractor\)%2C%20show%20me%20how%20to%20extract%20the%20text%20shown%20on%20screen%20in%20music-only%20Reels%20and%20TikToks.%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%20On-Screen%20Text%20Extractor%20\(OCR\)%20for%20Reels%20%26%20TikTok%22%20\(https%3A%2F%2Fapify.com%2Faemon%2Fvideo-on-screen-text-extractor\)%2C%20show%20me%20how%20to%20extract%20the%20text%20shown%20on%20screen%20in%20music-only%20Reels%20and%20TikToks.%20Include%20the%20input%20JSON%2C%20the%20output%20fields%20and%20how%20to%20run%20it%20through%20the%20API%2C%20the%20Apify%20MCP%20server%20or%20n8n.).

### FAQ

**How many frames are read?**
About one frame every 4 seconds, up to 5 frames per video, at a resolution where captions stay legible.

**Does it work on YouTube?**
No, YouTube is not supported for on-screen text. For YouTube transcripts use [Video to Text](https://apify.com/aemon/video-to-text-for-ai).

**Can I also get the hook and summary?**
Yes, turn on **AI analysis**, or use [TikTok & Reels Hook Analyzer](https://apify.com/aemon/tiktok-reels-hook-analyzer), which is set up for that.

### Support

Found a video where text was missed? Open an issue in the **Issues** tab with the link; 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-on-screen-text-extractor/changelog.md

# Actor input Schema

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

Links to TikTok videos, Instagram Reels, X posts with video or public Facebook videos, one per line. YouTube is not supported for on-screen text.

## `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.instagram.com/p/DULBkEngpxg",
    "https://www.tiktok.com/@apifylife/video/7338085038258457889"
  ],
  "maxVideosPerUrl": 1,
  "publishedAfter": "",
  "extractOnScreenText": true,
  "aiAnalysis": false,
  "translateTo": "none",
  "language": "auto",
  "preferPlatformCaptions": true,
  "includeSegments": true,
  "subtitleFormat": "none",
  "maxDurationMinutes": 120,
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `onScreenText` (type: `string`):

Text shown in each video, in order of appearance, next to the spoken transcript.

## `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.instagram.com/p/DULBkEngpxg",
        "https://www.tiktok.com/@apifylife/video/7338085038258457889"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("aemon/video-on-screen-text-extractor").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.instagram.com/p/DULBkEngpxg",
        "https://www.tiktok.com/@apifylife/video/7338085038258457889",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("aemon/video-on-screen-text-extractor").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.instagram.com/p/DULBkEngpxg",
    "https://www.tiktok.com/@apifylife/video/7338085038258457889"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call aemon/video-on-screen-text-extractor --silent --output-dataset

```

## MCP server setup

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

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/N6XC0CaFPYqKDOg9V/builds/uaHjMbm17kWVAylCr/openapi.json
