Get transcript for non-YouTube 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://twitter.com/user/status/123456789",
  "language": "en",
  "metadata_only": false,
  "fallback_to_metadata": false,
  "transcript_text": false
}
'

{
  "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>",
      "carousel_info": {
        "total_items": 123,
        "video_count": 123,
        "image_count": 123,
        "selected_index": 123
      }
    },
    "transcript": [
      {
        "text": "<string>",
        "start": 123,
        "end": 123
      }
    ]
  }
}

Online media

Get Video Transcript

Extract transcript from non-YouTube online videos (Vimeo, Twitter/X, TikTok, Facebook, Instagram, Dailymotion, Loom, etc.) with optional language selection.

For YouTube videos, use /youtube/transcript instead.

Options:

transcript_text=true: Returns the transcript as a single plain-text string instead of an array of segments.
metadata_only=true: Returns only video metadata (no transcript).
fallback_to_metadata=true: If transcript is unavailable, returns video metadata with an empty transcript instead of a 404 error (ignored when metadata_only=true).

POST

transcript

Get transcript for non-YouTube 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://twitter.com/user/status/123456789",
  "language": "en",
  "metadata_only": false,
  "fallback_to_metadata": false,
  "transcript_text": false
}
'

{
  "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>",
      "carousel_info": {
        "total_items": 123,
        "video_count": 123,
        "image_count": 123,
        "selected_index": 123
      }
    },
    "transcript": [
      {
        "text": "<string>",
        "start": 123,
        "end": 123
      }
    ]
  }
}

Extract accurate metadata and transcripts from online videos including TikTok, Facebook, X, Vimeo, Dailymotion, Loom, and other platforms.

For YouTube videos, please use the dedicated YouTube Transcript endpoint, which uses residential proxy infrastructure for reliable access.

Billing

Non-YouTube transcript retrieval consumes standard_request usage. 1 credit covers 10,000 Standard Requests.

Overview

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

Supported Platforms

VidNavigator can retrieve transcripts from a wide variety of sources. Below is the list of platforms currently supported by this endpoint:

X / Twitter (just copy the tweet video link)
Facebook (public videos only)
TikTok
Dailymotion
Loom
Vimeo

For YouTube videos, use the /youtube/transcript endpoint instead.

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

Request Parameters

Parameter	Type	Required	Description
`video_url`	string	Yes	URL of the video to transcribe
`language`	string	No	ISO2 language code (e.g., “en”, “es”, “fr”)
`metadata_only`	boolean	No	When `true`, returns only video metadata without fetching the transcript. Takes precedence over `fallback_to_metadata`.
`fallback_to_metadata`	boolean	No	When `true`, returns video metadata with an empty transcript if transcript is unavailable (returns 200 instead of 404). Ignored if `metadata_only` is `true`.
`transcript_text`	boolean	No	When `true`, returns the transcript as a single plain-text string instead of an array of segments.

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://twitter.com/user/status/123456789",
    "language": "en"
  }'

Transcript as Plain Text (`transcript_text=true`)

Use transcript_text=true to return the transcript as a single plain-text string instead of an array of { text, start, end } segments:

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://twitter.com/user/status/123456789",
    "transcript_text": "true"
  }'

Getting Metadata Only

If you only need video metadata without the transcript (faster and still counts as 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://www.tiktok.com/@user/video/123456789",
    "metadata_only": true
  }'

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. This endpoint supports direct links from X (a tweet), Vimeo, TikTok, 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. Consider using fallback_to_metadata: true to get metadata even when transcript is unavailable.
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 recommend not using the language input if you are unsure.
For YouTube videos: This endpoint does not support YouTube. Please use the /youtube/transcript endpoint instead.

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://twitter.com/user/status/123456789",
      "channel": "Example Creator",
      "duration": 45.5,
      "views": 123456,
      "likes": 9876,
      "published_date": "2024-01-15",
      "keywords": ["example", "twitter", "video"],
      "category": "Entertainment"
    },
    "transcript": [
      {
        "text": "This is the first sentence of the video.",
        "start": 0.5,
        "end": 3.2
      },
      {
        "text": "And this is the second sentence.",
        "start": 3.5,
        "end": 5.1
      }
    ]
  }
}

Response with `transcript_text: true`

When you set transcript_text: true, the transcript is returned as a single string:

{
  "status": "success",
  "data": {
    "video_info": { ... },
    "transcript": "This is the first sentence of the video. And this is the second sentence."
  }
}

Response with `metadata_only: true`

When you set metadata_only: true, only the video metadata is returned:

{
  "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://twitter.com/user/status/123456789",
      "channel": "Example Creator",
      "duration": 45.5,
      "views": 123456,
      "likes": 9876,
      "published_date": "2024-01-15"
    }
  }
}

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 retrieve transcript for

Example:

"https://twitter.com/user/status/123456789"

language

string

ISO2 language code (optional)

Required string length: 2

Example:

"en"

metadata_only

boolean

default:false

When true, returns only video metadata without transcript. Usage is still recorded.

fallback_to_metadata

boolean

default:false

When true, returns video metadata with an empty transcript if transcript is unavailable (200). Ignored if metadata_only is true.

transcript_text

boolean

default:false

When true, returns the transcript as a single plain-text string instead of an array of segments.

Response

Transcript retrieved successfully

status

enum<string>

Available options:

success

data

object

Show child attributes

Usage Costs Get YouTube Transcript

​Billing

​Overview

​Supported Platforms

​Use Cases

Content Analysis

Search & Discovery

Accessibility

Content Creation

​Request Parameters

​Example Usage

​Transcript as Plain Text (transcript_text=true)

​Getting Metadata Only

​Limitations

​Troubleshooting

​Success Response (200 OK)

​Response with transcript_text: true

​Response with metadata_only: true

Authorizations

Body

Response

Billing

Overview

Supported Platforms

Use Cases

Request Parameters

Example Usage

Transcript as Plain Text (`transcript_text=true`)

Getting Metadata Only

Limitations

Troubleshooting

Success Response (200 OK)

Response with `transcript_text: true`

Response with `metadata_only: true`