{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Reels Transcript API - Speech to Text & Screen Text",
    "description": "Get the transcript of an Instagram reel or video: paste reel links, usernames or a dataset and get the spoken words as text with timestamps, the 3-second hook, on-screen text, caption, views and likes. New reels only for schedules. No login. $30 per 1,000 reels; reels without speech are free.",
    "version": "1.0",
    "x-build-id": "HuoxL468fDwkgqI16"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tenfoldfleet~instagram-reels-transcript/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tenfoldfleet-instagram-reels-transcript",
        "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/tenfoldfleet~instagram-reels-transcript/runs": {
      "post": {
        "operationId": "runs-sync-tenfoldfleet-instagram-reels-transcript",
        "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/tenfoldfleet~instagram-reels-transcript/run-sync": {
      "post": {
        "operationId": "run-sync-tenfoldfleet-instagram-reels-transcript",
        "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": {
          "reels": {
            "title": "Reel URLs or shortcodes",
            "type": "array",
            "description": "Public Instagram reels or video posts to transcribe: full links (https://www.instagram.com/reel/CfY6jCIgH-P/, /p/... and /tv/... work too) or bare shortcodes (CfY6jCIgH-P). One reel = one result. Free Apify plan: the first 3 reels per run are transcribed. A run with a completely empty input transcribes one sample reel (billed like any reel) so you can see the output.",
            "items": {
              "type": "string"
            }
          },
          "usernames": {
            "title": "Usernames (latest reels)",
            "type": "array",
            "description": "Optional. Public Instagram accounts (username, @handle or profile URL). The actor transcribes each account's newest reels, up to \"Reels per profile\".",
            "items": {
              "type": "string"
            }
          },
          "datasetId": {
            "title": "Dataset of reels (from another Actor)",
            "type": "string",
            "description": "Optional. Pick a dataset in your account, or give its ID, to transcribe the reels listed in it: for example the results of an Instagram scraper or of Instagram Reels Search. A row counts when it has a reel link or shortcode in one of these fields: url, inputUrl, postUrl, reelUrl, videoUrl, shortCode, shortcode, code. Rows without one are skipped, reels already in \"Reel URLs or shortcodes\" are not repeated, and the first 5,000 rows are read. The Actor only gets read access to this one dataset. Free Apify plan: the first 3 reels per run are transcribed."
          },
          "maxReelsPerProfile": {
            "title": "Reels per profile",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "How many of each account's newest reels to transcribe (pinned reels count last). Instagram shows the 12 newest reels to logged-out visitors, so the maximum is 12.",
            "default": 10
          },
          "language": {
            "title": "Spoken language",
            "type": "string",
            "description": "Leave on auto to detect the language of each reel. Or give an ISO 639-1 code (en, es, pt, hi, fr, de, ...) as a hint for reels in that language. The transcript is always in the language actually spoken (no translation).",
            "default": "auto"
          },
          "includeSegments": {
            "title": "Timestamped segments",
            "type": "boolean",
            "description": "Add sentence-level segments with start and end times in seconds. Turn off if you only need the full transcript text. The hook (the words of the first 3 seconds) is returned either way.",
            "default": true
          },
          "onScreenText": {
            "title": "On-screen text",
            "type": "boolean",
            "description": "Also return the text visible in the video (titles, burned-in captions, stickers), read by an AI vision model from up to 4 frames spread over the reel. No extra charge. It is read for reels that are transcribed (reels without speech stay free and come back without it), and it adds a few seconds per reel. Text that only shows between the sampled frames is not captured.",
            "default": false
          },
          "onlyNew": {
            "title": "New reels only (for scheduled runs)",
            "type": "boolean",
            "description": "For \"Usernames\". When on, a reel that an earlier run of yours already transcribed is skipped at no charge, so a scheduled run only transcribes what was posted since the last run. The Actor remembers the newest 500 reels per username in a key-value store named instagram-reels-transcript-seen in your account; delete that store to start over. A reel that failed is tried again on the next run. Reels given as links or through a dataset are always transcribed. Free Apify plan: up to 3 new reels per run.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many reels to process in parallel.",
            "default": 10
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}