---
canonical_url: "https://docs.composio.dev/toolkits/get_transcribe"
markdown_url: "https://docs.composio.dev/toolkits/get_transcribe.md"
product: "platform"
version: null
last_updated: null
---

# GetTranscribe

GetTranscribe converts supported video and media URLs into searchable transcriptions and provides tools for managing transcription jobs, results, and folders.

- **Category:** transcription
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `GET_TRANSCRIBE`
- **Version:** 00000000_00

## Tools

### Create Transcription Job

**Slug:** `GET_TRANSCRIBE_CREATE_TRANSCRIPTION_JOB`

Queue a paid asynchronous transcription job for a supported public video or direct media URL. Returns a job ID to poll with Get Transcription Job; this operation can consume transcription credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Public Instagram, TikTok, YouTube, Facebook, X, Pinterest, Google Drive, or direct media URL to transcribe. |
| `model` | string ("accurate" | "fast" | "quality" | "speakers") | No | Transcription profile. The speakers profile identifies speakers and ignores prompt. |
| `prompt` | string | No | Names, jargon, and context that may improve transcription. This is ignored when model is speakers. |
| `language` | string | No | Optional ISO 639-1 language hint, such as en, es, or fr. |
| `folder_id` | integer | No | Existing folder ID in which to place the completed transcription. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Account

**Slug:** `GET_TRANSCRIBE_GET_CURRENT_ACCOUNT`

Return the connected GetTranscribe account's safe identity, plan, usage limits, and available balances.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Folder

**Slug:** `GET_TRANSCRIBE_GET_FOLDER`

Retrieve one transcription folder owned by the connected account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder_id` | integer | Yes | Folder ID from List Folders or a transcription record. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transcription

**Slug:** `GET_TRANSCRIBE_GET_TRANSCRIPTION`

Retrieve one completed transcription with its text and media metadata; optionally include potentially large word and segment timing arrays.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `transcription_id` | integer | Yes | Transcription ID, usually returned as transcription_id by a completed job. |
| `include_timing_data` | boolean | No | Include transcription_segments and transcription_words; leave false to avoid a potentially very large response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transcription Job

**Slug:** `GET_TRANSCRIBE_GET_TRANSCRIPTION_JOB`

Get the status and progress of one asynchronous transcription job, including the finished transcription ID or failure details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | integer | Yes | Job ID returned by Create Transcription Job. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Folders

**Slug:** `GET_TRANSCRIBE_LIST_FOLDERS`

List transcription folders owned by the connected account, optionally filtering by parent folder.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum folders to return in this page (1-50). |
| `parent_id` | integer | No | Optional parent folder ID filter. Omit it to request the account-wide folder collection. |
| `sort_order` | integer ("1" | "-1") | No | Sort by folder name: 1 ascending or -1 descending. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transcription Jobs

**Slug:** `GET_TRANSCRIBE_LIST_TRANSCRIPTION_JOBS`

List asynchronous transcription jobs for the connected account, optionally filtered by lifecycle status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum jobs to return in this page (1-50). |
| `status` | string ("pending" | "processing" | "completed" | "failed") | No | Optional lifecycle status filter. |
| `sort_order` | integer ("1" | "-1") | No | Sort by creation time: -1 for newest first or 1 for oldest first. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transcriptions

**Slug:** `GET_TRANSCRIBE_LIST_TRANSCRIPTIONS`

List lightweight completed-transcription metadata for the connected account, with folder and platform filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum transcription summaries to return in this page (1-50). |
| `platform` | string | No | Optional platform filter; documented values include youtube, instagram, and tiktok. |
| `folder_id` | integer | No | Optional folder ID filter. |
| `sort_order` | integer ("1" | "-1") | No | Sort by creation time: -1 for newest first or 1 for oldest first. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Resolve Media Download URL

**Slug:** `GET_TRANSCRIBE_RESOLVE_MEDIA_DOWNLOAD_URL`

Resolve a fresh direct download URL for supported social or direct media without creating a transcription. This paid request may consume provider credits, and returned URLs can expire.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Supported social, Google Drive, or direct media URL to resolve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |