{
  "openapi": "3.0.1",
  "info": {
    "title": "Instagram Transcript Scraper — Instagram Reels Transcript API",
    "description": "Instagram reel transcripts: reels as text — speech-to-text, first-3s hook, language, timestamps; a row per reel with date, plays, likes. Handle in, paste reel links or chain a dataset ID. No login. Private and failed reels are never charged; on-screen text read off a silent reel costs a transcript.",
    "version": "1.0",
    "x-build-id": "C4oISUnpweL67tI7a"
  },
  "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": "Instagram creators whose most recent reels are listed and transcribed, maxReelsPerHandle each — a handle or profile URL: nasa, @nasa or https://www.instagram.com/nasa/. The actor lists the reels itself; no scraper and no login needed. Private accounts, missing handles and creators with no reels come back as uncharged rows with the reason stated. Leave everything empty and the run is a 2-reel sample of zachking's latest reels, charged like any run — the fastest way to see real output.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Instagram links or creators",
            "type": "array",
            "description": "Anything Instagram, in one list: a reel or post link is transcribed, a creator (nasa, @nasa or instagram.com/nasa/) gets their latest reels, and a CDN .mp4 is transcribed directly. Entries may be plain links [\"https://www.instagram.com/nasa/\", \"nasa\"] or the crawler shape [{\"url\": \"https://www.instagram.com/nasa/\"}]; both are read. An entry it cannot place is an uncharged row saying what it looked like. The fields below still work; a reel sent twice is charged once. Language is auto-detected."
          },
          "maxReelsPerHandle": {
            "title": "Max reels per creator",
            "minimum": 1,
            "type": "integer",
            "description": "How many of each creator's most recent reels to transcribe, newest by date: a pinned reel is delivered in its real date position (flagged isPinned), never ahead of newer reels. Best-effort: if Instagram stops serving more part-way through, the run keeps what it listed, says so, and charges only for delivered transcripts. Ask for more than the actor's ceiling of 500 reels per creator and the run still starts, at 500, with one uncharged row saying what was asked and what bound it.",
            "default": 10
          },
          "reelUrls": {
            "title": "Instagram reel links",
            "type": "array",
            "description": "A list of reel or post links: 30 or 300 is a normal batch, up to maxItems; on a scheduled re-run, newReelsOnly skips reels bought in the last 90 days. Plain Instagram links (/reel/… or /p/…) or a shortCode. A video post or carousel: its first video is transcribed; photo-only: text in its first 5 images, one `image-text` charge per post. A /share/ link: paste the reel address it opens. Private, removed or copyright-blocked: uncharged, reason given. A handle (nasa, @nasa) reads as that creator.",
            "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 of any Instagram scraper result. A direct audio or video FILE on any other host goes to steadyfetch/media-transcriber, field urls. These links expire in about 1–3 days, so transcribe soon; an expired one is an uncharged row, as is any non-Instagram link here. A creator's handle or profile link (nasa, @nasa or instagram.com/nasa/) is read as that creator.",
            "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). Every row's reel is transcribed, up to maxItems per run (1,000 by default, 10,000 at most); reels this account bought in the last 90 days are handed back uncharged and do not count against it. 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": "On by default from 17 November 2026: a reel confirmed to have no speech (music-only or silent) has its on-screen text read and delivered as `onScreenText`, charged as one transcript; send false to turn it off. With it on, a reel whose silence could not be confirmed on a run comes back uncharged and can be run again. Reels with no readable on-screen text stay uncharged either way. A saved task, schedule or call that already sends false (a form saved before this build may carry it) stays off.",
            "default": true
          },
          "describeVideo": {
            "title": "Describe each reel",
            "type": "boolean",
            "description": "Adds what each transcribed reel shows: scenes (timed), description, videoSummary (for someone who cannot watch) and sound (what is heard: speech, music). ON: one Video description event per reel actually described, as listed on the Pricing tab, on top of its transcript. Reels with speech up to 3 minutes are described; one that is not says why, uncharged. On the Apify free plan, up to 5 reels an account are described in any 24 hours; paid plans have no such limit. OFF (default): rows unchanged.",
            "default": false
          },
          "watchlistId": {
            "title": "Watchlist name",
            "type": "string",
            "description": "Names a list that remembers every reel this actor answered for you, so New reels only (newReelsOnly) can skip them on later runs. Use a short name such as `acme-creators` (letters, numbers and hyphens). The list lives in a named key-value store in your account called `ig-reels-watch-<name>`, so you can inspect or clear it any time. Leave empty for a one-off run — your account's memory of delivered reels still applies."
          },
          "newReelsOnly": {
            "title": "New reels only",
            "type": "boolean",
            "description": "Whether reels bought in the last 90 days are skipped (with a watchlist name: that list's reels): not fetched or charged, counted in the status line and OUTPUT. OFF (default): they come from the earlier run uncharged (`repeat: true`); rows have `isNew` / `firstSeenAt`. Answered reels count (transcript, on-screen text or a final verdict like no speech); an expired URL, failed download or cost-cap cut is retried next run. Checks a creator's latest \"Max reels per creator\".",
            "default": false
          },
          "maxItems": {
            "title": "Max reels to process",
            "minimum": 1,
            "type": "integer",
            "description": "Max transcripts to deliver (reels with no speech are not charged and do not count unless their on-screen text is read). Long videos: the first 3 minutes are included in the transcript price; each started minute beyond that is charged as a \"Long video minute\" at $0.005 — only when the transcript is delivered, never on on-screen text. Ask for more than this actor serves in one run and the run still starts: it continues at the actor's own ceiling of 10,000 reels, with one uncharged row saying so.",
            "default": 1000
          },
          "maxRunSeconds": {
            "title": "Max run time (seconds)",
            "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. Anything outside the actor's own range of 90 to 7,200 seconds still starts a run: the clock is set to the nearest end of that range and one uncharged row says so. The run's own Timeout option still applies when it is shorter than this, and then it is the limit that ends the run.",
            "default": 7200
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}