---
title: "Subtitle Converter"
method: POST
path: "/api/v1/tools/subtitle-converter"
tags: ["tools"]
---

# Subtitle Converter

`POST /api/v1/tools/subtitle-converter`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/subtitle-converter`
- Auth: HTTP bearer

Convert subtitles between SRT and WebVTT or to a plain transcript, shift or stretch the timing, append a second part, and repair order, overlaps, empty and flashing cues. Returns the rewritten subtitle text and a report of what changed.

## Request body

- object
  - `text` string
  - `format` string
  - `shiftSeconds` number
  - `scalePercent` number
  - `repair` boolean
  - `appendText` string
  - `appendOffsetSeconds` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `result` string
    - `format` string
    - `inputFormat` string
    - `cues` integer
    - `durationMs` integer
    - `notes` unknown[]
      - unknown
    - `repairs` object
      - `reordered` boolean
      - `emptyRemoved` integer
      - `overlapsFixed` integer
      - `negativeClamped` integer
      - `tooShortExtended` integer

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)