Skip to main content

Turn video into
structured data.

Timestamped transcripts, channel uploads and visual analysis for your product. Use REST in your code or MCP in your AI assistant.

HTTPS   •   Authenticated routes   •   Delete history anytime

curl -X POST https://vidwords.com/api/transcripts \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["dQw4w9WgXcQ"],
    "lang": "en"
  }'
Response shape · illustrative
{
  "results": [{
    "id": "VIDEO_ID",
    "languageCode": "en",
    "text": "Caption text…",
    "segments": [{
      "start": 0,
      "duration": 4.35,
      "text": "Caption text…"
    }]
  }]
}

Illustrative segments

  • We separate transcripts and Watch minutes.
  • One clear bill. Two allowances.
  • Turn video into structured data.
  • Transcripts, timestamps and summaries.

Single videos

Fetch full text and timestamped caption segments.

Batch requests

Fetch transcripts for up to 50 videos in one request.

Channel lookup

List up to 500 recent uploads and their metadata.

Clear JSON

Handle successes and per-item errors in one response.

Build the workflow around the video.

Start with transcripts and channel uploads, then add AI Watch when your workflow needs on-screen evidence.

1. Transcript and channel requests

Send one video, a batch of IDs, a channel handle or a channel URL.

POST /api/transcripts1 videoFull text
POST /api/transcriptsUp to 50Batch
POST /api/channels@handleUploads
POST /api/channelsUC… IDMetadata
Explore all endpoints →

2. Per-video results

Each requested video returns its own transcript data or a specific error.

{
  "results": [{
    "id": "dQw4w9WgXcQ",
    "languageCode": "en",
    "text": "Welcome to the product update…",
    "segments": [{
      "start": 0.24,
      "duration": 3.18,
      "text": "Welcome to the product update…"
    }]
  }]
}
LanguageenBCP-47
Caption sourceManual / autoExplicit
FailuresPer itemActionable

3. Structured JSON

Use the representation that fits your pipeline.


Full text

Segments

Start

Duration

Language

Metadata
See response schemas →
Ready for your first request?Get your API key and turn video into clean, structured data.
Get API key Read documentation