{ "openapi": "3.0.1", "info": { "title": "Facebook Video & Reel Transcript Scraper — Text, SRT & VTT", "description": "Facebook video and Reel transcripts. Paste any facebook.com or fb.watch link and get full text, timestamped segments, word-level timings, SRT and VTT files, HD video and thumbnail URLs, plus post metadata. Whisper runs inside the Actor — no API key. 99+ languages. Billed per second.", "version": "0.0", "x-build-id": "UqoUsPk9Z3Qyc45Kb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~facebook-video-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-facebook-video-transcript-scraper", "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/memo23~facebook-video-transcript-scraper/runs": { "post": { "operationId": "runs-sync-memo23-facebook-video-transcript-scraper", "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/memo23~facebook-video-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-facebook-video-transcript-scraper", "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", "properties": { "videoUrls": { "title": "Facebook video / Reel URLs", "type": "array", "description": "One or more Facebook links, one per line. Reels, Watch videos and page videos all work:\n\n- `https://www.facebook.com/reel/636216875539019`\n- `https://www.facebook.com/watch/?v=1234567890`\n- `https://www.facebook.com/PageName/videos/1234567890`\n- `https://fb.watch/AbCdEfGh/`\n\nPrivate or friends-only posts need a `cookies.txt` — see the Cookies field below.", "items": { "type": "string" } }, "language": { "title": "Language (optional)", "type": "string", "description": "ISO 639-1 code of the spoken language (`en`, `es`, `pt`, `de`, …). Leave empty to auto-detect — detection is reliable on clear speech and costs nothing extra." }, "model": { "title": "Whisper model", "enum": [ "tiny", "base", "small" ], "type": "string", "description": "Accuracy against speed. `base` is the right default for most Reels; `small` is worth it for accents, background music or technical vocabulary; `tiny` is for bulk runs where speed matters more than the last few percent.", "default": "base" }, "translateToEnglish": { "title": "Translate to English", "type": "boolean", "description": "Return an English translation instead of the original language. Works from any of the 99+ supported source languages.", "default": false }, "wordTimestamps": { "title": "Word-level timestamps", "type": "boolean", "description": "Add per-word start/end times and confidence inside every segment (`segments[].words`). Needed for karaoke-style captions, precise clip cutting and word-accurate search. Costs roughly 15-25% extra transcription time.", "default": false }, "maxMinutesPerItem": { "title": "Max minutes per video", "minimum": 1, "maximum": 600, "type": "integer", "description": "Safety cap on how much of each video is transcribed. Longer videos are transcribed up to the cap and the row says how much was covered. Keeps a stray 3-hour livestream replay from eating the run.", "default": 120 }, "cookies": { "title": "Cookies (optional)", "type": "string", "description": "Contents of a Netscape `cookies.txt` exported from a browser where the post opens normally. Only needed for private, friends-only or age-gated videos — public Reels and page videos work without it." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. This Actor downloads through its own residential pool, so Facebook works without you configuring anything and without spending your proxy quota. Turn on Apify Proxy here only if you want it as an extra fallback, or paste your own proxy URLs to use those exclusively.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }