POST
/
transcript
Get transcript for online videos
curl --request POST \
  --url https://api.vidnavigator.com/v1/transcript \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "video_url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
  "language": "en"
}'
{
  "status": "success",
  "data": {
    "video_info": {
      "title": "<string>",
      "description": "<string>",
      "thumbnail": "<string>",
      "url": "<string>",
      "channel": "<string>",
      "channel_url": "<string>",
      "duration": 123,
      "views": 123,
      "likes": 123,
      "published_date": "<string>",
      "keywords": [
        "<string>"
      ],
      "category": "<string>",
      "available_languages": [
        "<string>"
      ],
      "selected_language": "<string>"
    },
    "transcript": [
      {
        "text": "<string>",
        "start": 123,
        "end": 123
      }
    ]
  }
}
Extract accurate metadata and transcripts from online videos including YouTube, TikTok, Facebook, X, Vimeo, Dailymotion, Loom, and other platforms.

​
Overview

This endpoint automatically extracts rich video metadata and transcripts from online videos with high accuracy.

​
Supported Platforms

VidNavigator can retrieve transcripts from a wide variety of sources. Below is the continuously-growing list of platforms currently supported:
  • YouTube
  • X / Twitter (just copy the tweet video link)
  • Facebook (public videos only)
  • TikTok
  • Dailymotion
  • Loom
  • Vimeo

​
Use Cases

Content Analysis

Extract transcripts for AI analysis, sentiment analysis, or content categorization

Search & Discovery

Enable text-based search across video content libraries

Accessibility

Generate captions and transcripts for accessibility compliance

Content Creation

Create summaries, articles, or repurpose video content

​
Example Usage

curl -X POST "https://api.vidnavigator.com/v1/transcript" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en"
  }'

​
Limitations

  • https://fb.watch/<video_id> format is not supported, use the https://www.facebook.com/watch/?v=<video_id> format instead.

​
Troubleshooting

  • Invalid URL: Ensure the video URL is complete and valid, as the actor supports only direct links from YouTube, X (a tweet), Vimeo, etc …
  • Transcript Not Found: Please ensure that the video has subtitles available (either manually added or auto-generated). If no subtitles are present, the transcript cannot be extracted.
  • Language Not Supported: Sometimes the selected subtitles language is not available. In which case, you will get a clear message stating that. Verify that the chosen language is available for the video. We recommand not using the language input if you are unsure. For youtube videos you can check out the available_languages field in the JSON output.
If issues persist or need more help, please reach out to us at support@vidnavigator.com.

​
Success Response (200 OK)

Returns a video_info object and a transcript object. 
{
  "status": "success",
  "data": {
    "video_info": {
      "title": "A Really Cool Video",
      "description": "An example description for the video.",
      "thumbnail": "https://example.com/thumbnail.jpg",
      "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
      "channel": "Example Creator",
      "duration": 212.5,
      "views": 123456789,
      "likes": 987654,
      "published_date": "2009-10-25",
      "keywords": ["example", "youtube", "video"],
      "category": "Music",
      "available_languages": ["en", "es", "fr"],
      "selected_language": "en"
    },
    "transcript": [
      {
        "text": "We're no strangers to love",
        "start": 0.5,
        "end": 3.2
      },
      {
        "text": "You know the rules and so do I",
        "start": 3.5,
        "end": 5.1
      }
    ]
  }
}

Authorizations

​
X-API-Key
string
header
required

API key authentication. Include your VidNavigator API key in the X-API-Key header.

Body

application/json
​
video_url
string<uri>
required

URL of the video to transcribe

Example:

"https://youtube.com/watch?v=dQw4w9WgXcQ"

​
language
string

ISO2 language code (optional)

Required string length: 2
Example:

"en"

Response

Transcript retrieved successfully

​
status
enum<string>
Available options:
success
​
data
object