# Tiktok | Instagram | Facebook | Transcriber (`tictechid/anoxvanzi-transcriber`)

Extract accurate transcripts from Instagram Reels, Facebook Reels and TikTok videos. Use video URLs to transcribe public content with timestamps. Export transcripts in JSON format, run via API, schedule runs, or integrate with other tools for automated transcription workflows.

- **URL**: https://beta-securitybyobscurity.apify.com/tictechid/anoxvanzi-transcriber.md
- **Developed by:** [TicTech](https://beta-securitybyobscurity.apify.com/tictechid) (community)
- **Categories:** Social media, Videos, Automation
- **Stats:** 636 total users, 179 monthly users, 100.0% runs succeeded, 27 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

Pay per event

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/platform/actors/running/actors-in-store#pay-per-event

# README

## Social Video Transcriber

Transform your social videos into actionable insights! Instantly convert Instagram Reels, TikTok, and Facebook Reels into searchable, timestamped transcripts with automatic language detection. Unlock the full value of your content for analysis, accessibility, and growth.

> **Note:** Only publicly available videos can be transcribed. Private or restricted videos are not supported.

> **Important:** Due to Instagram's tight CORS security and anti-scraping/bot measures, success rates for Instagram Reels are not guaranteed. The platform actively blocks automated access, which may result in failed downloads even for public content.

### Why Use This Tool?

- **Automate tedious work:** No more manual transcription—get results in minutes, not hours.
- **Unlock hidden insights:** Search, analyze, and repurpose your video content for new opportunities.
- **Boost accessibility:** Make your videos inclusive for all audiences with accurate transcripts.
- **Enhance discoverability:** Improve SEO and compliance with rich, timestamped text.
- **Stay ahead:** Track trends, monitor competitors, and optimize your content strategy with ease.

### Features

- Supports Instagram Reels, TikTok, and Facebook Reels (public videos only)
- Outputs transcript with timestamps and detected language
- Detects and outputs the dominant spoken language (see supported languages below)
- Handles videos up to 30 minutes (1800 seconds)

### Use Cases

- **Content Creators:** Generate captions, repurpose content, and analyze performance.
- **Marketers:** Track brand mentions, analyze trends, and optimize strategy.
- **Researchers:** Study social media trends and extract insights from public discourse.
- **Businesses:** Create training materials, monitor feedback, and maintain compliance records.

### Supported Languages

- Spanish: `es`
- English: `en`
- Hindi: `hi`
- Japanese: `ja`
- Russian: `ru`
- Ukrainian: `uk`
- Swedish: `sv`
- Chinese: `zh`
- Portuguese: `pt`
- Dutch: `nl`
- Turkish: `tr`
- French: `fr`
- German: `de`
- Indonesian: `id`
- Korean: `ko`
- Italian: `it`

### Input Example

```json
{
  "start_urls": "https://www.instagram.com/reel/example/",
}
```

### Output Example (Success)

```json
{
  "sourceUrl": "https://www.instagram.com/reel/example/",
  "videoId": "unique-video-id",
  "status": "success",
  "durationSec": 45.2,
  "transcript": "[0.00s - 2.50s] Welcome to my channel! [2.50s - 8.10s] Today I'm going to show you how to make the perfect pasta dish.",
  "detected_language": "en",
  "timestamp": "2024-01-01T12:00:00.000Z"
}
```

### Output Example (Failed)

```json
{
  "sourceUrl": "https://www.instagram.com/reel/private/",
  "videoId": "unique-video-id",
  "status": "failed",
  "error": "Failed to download video (video may be private or restricted)",
  "timestamp": "2024-01-01T12:00:00.000Z"
}
```

#### Output Fields

- **sourceUrl**: Original video URL
- **videoId**: Unique identifier for the video
- **status**: "success" or "failed"
- **durationSec**: Video duration in seconds (only for success)
- **transcript**: Transcription with timestamps (only for success)
- **detected\_language**: BCP-47 code for the detected language (only for success)
- **error**: Error message (only for failed outputs)
- **timestamp**: Processing time

### Usage

1. Provide a public video URL as `start_urls` in the input. Private or restricted videos are not supported.
2. The output will include the transcript, timestamps, and detected language code if successful, or an error message if failed.

### Pricing (Pay‑Per‑Event)

This Actor uses Apify's Pay‑Per‑Event (PPE) model for fair usage: you pay only when you receive value.

- **Event: Actor Start**
  - Charged once when the Actor run starts.
    - Tiered pricing:
    - **Free users**: $0.01
    - **Bronze**: $0.008
    - **Silver**: $0.006
    - **Gold**: $0.005

- **Event: Transcription Per Second**
  - Charged per second of transcribed audio, rounded to the nearest second.
  - You are charged only when a transcription is successfully produced.
  - Tiered pricing (per second):
    - **Free users**: $0.0025 / second
    - **Bronze**: $0.0015 / second
    - **Silver**: $0.0012 / second
    - **Gold**: $0.0010 / second

#### Why PPE is advantageous

- **Fair usage**: Pay only when a transcription is returned (plus a small startup fee). If downloading fails (e.g., private, age‑restricted, geo‑blocked), you are not charged for transcription time.
- **Transparent costs**: Prices are tied to concrete events you can reason about and monitor.
- **Scales with value**: Short clips cost less; longer clips cost more, proportional to usage.
- **Predictable controls**: Apify caps total charges per run/user based on your configuration in the console.

***

For more details, contact the maintainer or email us at contact@tictech.id

# Actor input Schema

## `start_urls` (type: `string`):

Instagram, TikTok, or Facebook Reels link

## Actor input object example

```json
{
  "start_urls": "https://www.facebook.com/reel/example"
}
```

# 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 = {
    "start_urls": "https://www.facebook.com/reel/example"
};

// Run the Actor and wait for it to finish
const run = await client.actor("tictechid/anoxvanzi-transcriber").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 = { "start_urls": "https://www.facebook.com/reel/example" }

# Run the Actor and wait for it to finish
run = client.actor("tictechid/anoxvanzi-transcriber").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "start_urls": "https://www.facebook.com/reel/example"
}' |
apify call tictechid/anoxvanzi-transcriber --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=tictechid/anoxvanzi-transcriber",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Tiktok | Instagram | Facebook | Transcriber",
        "description": "Extract accurate transcripts from Instagram Reels, Facebook Reels and TikTok videos. Use video URLs to transcribe public content with timestamps. Export transcripts in JSON format, run via API, schedule runs, or integrate with other tools for automated transcription workflows.",
        "version": "1.0",
        "x-build-id": "vu593hyrfpfUeQFBw"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/tictechid~anoxvanzi-transcriber/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-tictechid-anoxvanzi-transcriber",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/tictechid~anoxvanzi-transcriber/runs": {
            "post": {
                "operationId": "runs-sync-tictechid-anoxvanzi-transcriber",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/tictechid~anoxvanzi-transcriber/run-sync": {
            "post": {
                "operationId": "run-sync-tictechid-anoxvanzi-transcriber",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "start_urls"
                ],
                "properties": {
                    "start_urls": {
                        "title": "Video URL",
                        "type": "string",
                        "description": "Instagram, TikTok, or Facebook Reels link"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
