Description
n8n-nodes-get-transcribe
This is an n8n node for integrating with the GetTranscribe API, which allows you to transcribe videos from social media platforms like Instagram, TikTok, YouTube, and more.
Features
Jobs (recommended)
- Create: Start an async transcription job from a video URL (returns immediately with
pendingstatus) - Get: Poll a job by ID until
completedorfailed - List: List jobs with optional status filter
- Get: Get a completed transcription by ID (use after a Job finishes)
- List: List all transcriptions with optional filters
- Create (Deprecated): Synchronous create — still works for existing workflows, but prefer Job → Create
- Create: Create new folders to organize transcriptions
- List: List all folders
- Update: Update properties of existing folders
- Get: Get user information and account statistics
- Instagram:
https://www.instagram.com/p/ABC123/ - TikTok:
https://www.tiktok.com/@user/video/123456789 - YouTube:
https://www.youtube.com/watch?v=ABC123 pending/processing: not ready yet — wait and poll againcompleted: usetranscription_idto fetch the transcriptfailed: checkerror_message
When a job completes, use the returned transcription_id with the Transcription Get operation to fetch the full transcript.
Transcriptions
Folders
User
Installation
Installation on n8n Cloud
1. Go to Settings > Community Nodes
2. Search for n8n-nodes-get-transcribe
3. Click Install
Installation on self-hosted n8n
1. Go to your n8n installation root directory
2. Run: npm install n8n-nodes-get-transcribe
3. Restart n8n
Configuration
Credentials
To use this node, you need to configure your GetTranscribe credentials:
1. In n8n, go to Credentials and create new credentials of type GetTranscribe API
2. Enter your API Key from GetTranscribe
– You can find your API Key in your GetTranscribe account settings
– The API Key should have the format: gt_...
Credential test URL
The node will automatically verify your credentials by making a request to /users/me on the GetTranscribe API.
Usage
Create a Transcription Job (recommended)
1. Add the GetTranscribe node to your workflow
2. Select Job as resource
3. Select Create as operation
4. Enter the URL of the video you want to transcribe
5. Optionally set folder ID, language, prompt, or model
The node returns a job with id and status: "pending". Poll with Job → Get until status is completed or failed. On success, transcription_id points to the finished transcript.
Typical n8n pattern:
1. GetTranscribe (Job → Create)
2. Wait a few seconds
3. GetTranscribe (Job → Get) using the job id
4. IF status is still pending/processing → loop back to Wait
5. When completed → GetTranscribe (Transcription → Get) with transcription_id
Supported URL examples:
Get a Transcription Job
1. Select Job as resource
2. Select Get as operation
3. Enter the Job ID from the Create response
Statuses:
List Jobs
1. Select Job as resource
2. Select List as operation
3. Optionally filter by status (pending, processing, completed, failed)
Create a Transcription (deprecated)
> Deprecated. Use Job → Create instead. This sync path remains for existing workflows but can time out on long videos.
1. Select Transcription as resource
2. Select Create (Deprecated) as operation
3. Enter the URL of the video you want to transcribe
List Transcriptions
1. Select Transcription as resource
2. Select List as operation
3. Configure optional filters:
– Limit: Maximum number of results
– Skip: Number of results to skip (for pagination)
– Folder ID: Filter by specific folder
– Platform: Filter by platform (Instagram, TikTok, YouTube)
Folder Management
#### Create Folder
1. Select Folder as resource
2. Select Create as operation
3. Enter the folder name
4. Optionally, specify a parent folder ID to create subfolders
#### List Folders
1. Select Folder as resource
2. Select List as operation
3. Configure the result limit
User Information
1. Select User as resource
2. Select Get as operation
3. Enter your user ID (you can use your own ID)
API Response
Transcription
{
"id": 4032,
"user_id": 2,
"transcription": "Transcribed text from the video...",
"platform": "instagram",
"url": "https://www.instagram.com/p/DM1P8q1MzaG/",
"thumbnail_url": "https://...",
"downloadvideourl": "https://...",
"downloadaudiourl": "https://...",
"duration": "0:30",
"duration_seconds": 30.159864,
"word_count": 91,
"char_count": 515,
"folder_id": null,
"transcription_analysis": null,
"original_transcription": "Original text...",
"transcription_segments": [...],
"transcription_words": [...],
"created_at": "2025-08-07T17:43:15.822Z",
"updated_at": "2025-08-07T17:43:15.822Z"
}
Workflow Examples
Automatic Transcription from Webhook
1. Webhook Trigger – Receives video URLs
2. GetTranscribe (Job → Create) – Starts the job
3. Wait + GetTranscribe (Job → Get) – Poll until completed
4. GetTranscribe (Transcription → Get) – Fetch the transcript
5. HTTP Request – Sends the transcription to another service
Batch Processing
1. Schedule Trigger – Runs periodically
2. GetTranscribe (Job → List or Transcription → List)
3. If Node – Checks for new/completed items
4. Loop – Processes each item
Support
Contributing
Contributions are welcome! Please:
1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request
Contributors
Thanks to all the people who have contributed to this project:
License
MIT
Changelog
v0.2.1
v0.2.0
/transcription-jobs)
