{ "openapi": "3.0.1", "info": { "title": "Instagram Reels to Text · @handle", "description": "Handle in, transcripts out: a creator's recent reels turned into text with a 3-second hook. Music-only, private and failed reels are never charged. No login, any length, one box — every row also carries the post's date, plays and likes. Or paste reel links, or chain a dataset ID.", "version": "1.0", "x-build-id": "Rwj4oi52Y1BXgr8D4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~instagram-reel-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-instagram-reel-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/steadyfetch~instagram-reel-transcript-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-instagram-reel-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/steadyfetch~instagram-reel-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-instagram-reel-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": { "handles": { "title": "Instagram creators", "type": "array", "description": "Handles or profile URLs — nasa, @nasa or https://www.instagram.com/nasa/. The actor lists that creator's most recent reels itself and transcribes them; no scraper and no login needed. Private accounts, missing handles and creators with no reels come back as uncharged rows with the reason stated.", "items": { "type": "string" } }, "maxReelsPerHandle": { "title": "Max reels per creator", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many of each creator's most recent reels to transcribe. Best-effort: if Instagram stops serving more part-way through, the run keeps what it listed, says so, and charges only for delivered transcripts.", "default": 10 }, "reelUrls": { "title": "Instagram reel links", "type": "array", "description": "Plain Instagram links — instagram.com/reel/…/ or instagram.com/p/…/ — exactly as copied from the app or browser. The actor resolves each reel's video itself; links that can't be resolved (private, removed, or embed-restricted posts) come back as uncharged rows with the reason stated.", "items": { "type": "string" } }, "videoUrls": { "title": "Reel video/audio URLs", "type": "array", "description": "Instagram CDN media links (.mp4 on scontent-*.cdninstagram.com, instagram.f*.fna.fbcdn.net, or video.*.fbcdn.net) — the videoUrl / audioUrl field from any Instagram scraper result. These signed URLs expire in about 1–3 days, so transcribe soon after scraping; expired rows come back uncharged.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset ID (chain a scraper run)", "type": "string", "description": "The default dataset ID of a finished Instagram scraper run (works with apify/instagram-scraper, instagram-reel-scraper, instagram-post-scraper, instagram-api-scraper and others). With Apify's 'Connect actor' integration this is filled automatically — the cleanest way to chain." }, "datasetItems": { "title": "Dataset items (paste rows)", "type": "array", "description": "Paste rows from your Instagram scraper run. The actor deep-scans each row for reel video/audio URLs + metadata (creator, caption, short code) — works with any scraper's output shape, including nested posts." }, "includeOnScreenText": { "title": "Read on-screen text on silent reels", "type": "boolean", "description": "OFF (default): a reel with no speech is never charged. ON: music-only and silent reels have their on-screen text read from the reel's own frames and delivered as `onScreenText`, charged like a transcript. Reels with no readable on-screen text stay uncharged either way. About 1 in 6 reels is music-only.", "default": false }, "maxItems": { "title": "Max reels to process", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Safety cap on how many reels/videos to transcribe in one run, across every input above.", "default": 1000 }, "maxRunSeconds": { "title": "Max run time (seconds)", "minimum": 30, "maximum": 3600, "type": "integer", "description": "Wall-clock bound for the whole run, counted from when the run started. Reels still waiting when it is reached come back as uncharged rows saying so, and the run finishes cleanly instead of being cut off.", "default": 3600 } } }, "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 } } } } } } } } } }