Developer access

Transcription API

Send a video URL and let Vidiscribe return a transcript. The API uses the same transcription engine as the web app.

Base URL https://www.vidiscribe.com

Authentication

Requests must come from a signed-in account. The web app stores the session in the jwt cookie. Unauthenticated requests are redirected to the login page.

POST /transcribe/process

Create a transcript job from a YouTube, TikTok, Instagram, or direct media URL.

Request body

{
  "videoUrl": "https://www.youtube.com/watch?v=...",
  "language": "en"
}

curl -X POST "https://www.vidiscribe.com/transcribe/process" \
  -H "Content-Type: application/json" \
  -H "Cookie: jwt=YOUR_SESSION_TOKEN" \
  -d '{"videoUrl":"https://www.youtube.com/watch?v=...","language":"en"}'

videoUrl: Required string. A supported video or direct media URL.
language: Optional string such as en, es, or fr.

Platform endpoints

Use a platform-specific endpoint when you already know where the video is hosted. Each endpoint accepts the same request body and returns a redirect to the transcript result page.

POST /youtube-transcript/process

Transcribe a YouTube video or Short.

curl -X POST "https://www.vidiscribe.com/youtube-transcript/process" \
  -H "Content-Type: application/json" \
  -H "Cookie: jwt=YOUR_SESSION_TOKEN" \
  -d '{"videoUrl":"https://www.youtube.com/watch?v=...","language":"en"}'

POST /tiktok-transcript/process

Transcribe a TikTok video.

curl -X POST "https://www.vidiscribe.com/tiktok-transcript/process" \
  -H "Content-Type: application/json" \
  -H "Cookie: jwt=YOUR_SESSION_TOKEN" \
  -d '{"videoUrl":"https://www.tiktok.com/@creator/video/...","language":"en"}'

POST /instagram-transcript/process

Transcribe an Instagram Reel.

curl -X POST "https://www.vidiscribe.com/instagram-transcript/process" \
  -H "Content-Type: application/json" \
  -H "Cookie: jwt=YOUR_SESSION_TOKEN" \
  -d '{"videoUrl":"https://www.instagram.com/reel/...","language":"en"}'

GET /transcribe/result/:id

Open the result page for the transcript job returned after submission.

https://www.vidiscribe.com/transcribe/result/TRANSCRIPT_ID

The result page reports the job status and displays the transcript and summary when processing is complete.

Job statuses

PENDING

Waiting to be processed.

EXTRACTING

Preparing audio from the source.

TRANSCRIBING

Converting audio to text.

SUMMARISING

Generating the summary.

COMPLETED

Transcript and summary are ready.

FAILED

The job could not be completed.

GitHub