Single videos
Fetch full text and timestamped caption segments.
VidWords API
Turn video into
structured data.
Timestamped transcripts and channel video metadata—ready for your product or workflow.
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"
}'import requests
data = requests.post(
"https://vidwords.com/api/transcripts",
headers={"Authorization": "Basic YOUR_API_KEY"},
json={"ids": ["dQw4w9WgXcQ"], "lang": "en"}
).json()const data = await fetch(
"https://vidwords.com/api/transcripts", {
method: "POST",
headers: { "Authorization": "Basic YOUR_API_KEY" },
body: JSON.stringify({ ids: ["dQw4w9WgXcQ"] })
}
).then(r => r.json());Response
{
"status": "completed",
"language": "en",
"duration_seconds": 142,
"segments": [
{ "start": 0.00,
"end": 4.35,
"text": "We separate transcripts and Watch minutes..." }
]
}Transcript preview
- We separate transcripts and Watch minutes.
- One clear bill. Two allowances.
- Turn video into structured data.
- Transcripts, timestamps and summaries.
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.
From link to data.
Build the workflow around the video.
Two focused endpoints return transcripts, timed segments and channel uploads in clean JSON.
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
View both 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
Ready for your first request?Get your API key and turn video into clean, structured data.