{
  "openapi": "3.0.1",
  "info": {
    "title": "Video Transcript & Translation: YouTube, TikTok, Reels to Text",
    "description": "Video to text: transcripts and SRT/VTT subtitles of YouTube, TikTok, Instagram Reels, Facebook and X videos; translate them into Ukrainian and 20 more languages in the same run (multilingual). Captions first, Whisper speech to text when there are none. Failed videos are free. No API key.",
    "version": "0.1",
    "x-build-id": "IF9rUdnSydElGInKC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/ai_admin~social-video-transcript/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-ai_admin-social-video-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/ai_admin~social-video-transcript/runs": {
      "post": {
        "operationId": "runs-sync-ai_admin-social-video-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/ai_admin~social-video-transcript/run-sync": {
      "post": {
        "operationId": "run-sync-ai_admin-social-video-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",
        "required": [
          "videoUrls"
        ],
        "properties": {
          "videoUrls": {
            "title": "Video URLs",
            "type": "array",
            "description": "Links to single videos: YouTube (videos, Shorts), TikTok, Instagram Reels, Facebook videos and Reels, X (Twitter), Vimeo and 1,000+ other sites. Profile, playlist and search pages are not supported.",
            "default": [
              "https://www.tiktok.com/@nasa/video/7698805564884733198"
            ],
            "items": {
              "type": "string"
            }
          },
          "translateTo": {
            "title": "Translate to",
            "enum": [
              "",
              "en",
              "uk",
              "ru",
              "de",
              "fr",
              "es",
              "pt",
              "it",
              "pl",
              "nl",
              "tr",
              "cs",
              "ro",
              "sv",
              "ar",
              "hi",
              "id",
              "vi",
              "zh",
              "ja",
              "ko"
            ],
            "type": "string",
            "description": "Optional: also translate the transcript and subtitles into this language. Leave empty for the original language only.",
            "default": ""
          },
          "language": {
            "title": "Spoken language",
            "type": "string",
            "description": "ISO 639-1 code of the spoken language (en, uk, es, de, ...). Leave empty to detect it automatically.",
            "default": ""
          },
          "vocabulary": {
            "title": "Vocabulary hint",
            "type": "string",
            "description": "Optional names, terms and spellings said in the videos (e.g. \"Kyivstar, PrivatBank, Zelensky\"). Used only when the speech is recognised (no captions). Ukrainian city names are built in when the language is set to English, Ukrainian or Russian.",
            "default": ""
          },
          "useCaptions": {
            "title": "Use the video's captions when available",
            "type": "boolean",
            "description": "On: uploaded or automatic captions are used when the video has them (fast, any length, one flat price). Off: the speech is always recognised with Whisper (better punctuation, charged per minute).",
            "default": true
          },
          "maxDurationMinutes": {
            "title": "Maximum video length for speech recognition (minutes)",
            "minimum": 1,
            "maximum": 600,
            "type": "integer",
            "description": "Videos without captions that are longer than this are skipped (not charged). Captions are used for any length.",
            "default": 60
          },
          "quality": {
            "title": "Speech recognition model",
            "enum": [
              "accurate",
              "fast"
            ],
            "type": "string",
            "description": "accurate = Whisper large-v3 (best for non-English languages); fast = Whisper large-v3-turbo. Same price.",
            "default": "accurate"
          },
          "crossCheck": {
            "title": "Cross-check with the second model",
            "type": "boolean",
            "description": "Speech recognition only: recognise the audio again with the other Whisper model and list the places where the two disagree (crossCheck.differences, with times). Noise breaks numbers and short words, and the two models break them differently, so these are the places worth listening to. Doubles the speech recognition price; captions are not affected.",
            "default": false
          },
          "subtitles": {
            "title": "SRT and VTT subtitle files",
            "type": "boolean",
            "description": "Also save SRT and VTT files (original and translation) with download links (free).",
            "default": true
          },
          "includeSegments": {
            "title": "Timestamped segments",
            "type": "boolean",
            "description": "Include the timestamped segments (start, end, text) in the output, not only the full text.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}