Expert clip retrieval API

GET /api/v1/transcript

Fetch cached or live YouTube transcript segments for a video.

videoId (required) or url; maxSegments optional

curl

curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.youtubetimesearch.com/api/v1/transcript?videoId=dQw4w9WgXcQ"

JavaScript

const res = await fetch(
  `https://www.youtubetimesearch.com/api/v1/transcript?videoId=dQw4w9WgXcQ`,
  { headers: { Authorization: `Bearer ${apiKey}` } }
);
const data = await res.json();

Python

import requests
r = requests.get(
    "https://www.youtubetimesearch.com/api/v1/transcript",
    params={"videoId": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {api_key}"},
)
print(r.json())

GET /api/v1/search

Semantic + keyword search across indexed expert transcript moments.

q (required), limit (default 10, max 50)

curl

curl -s -H "x-api-key: YOUR_API_KEY" \
  "https://www.youtubetimesearch.com/api/v1/search?q=rag+vs+mcp&limit=5"

JavaScript

const res = await fetch(
  `https://www.youtubetimesearch.com/api/v1/search?q=${encodeURIComponent("rag vs mcp")}&limit=5`,
  { headers: { "x-api-key": apiKey } }
);

Python

requests.get("https://www.youtubetimesearch.com/api/v1/search", params={"q": "rag vs mcp", "limit": 5}, headers={"x-api-key": api_key})

POST /api/v1/answer

Authority-ranked answer with timestamped source moment and supporting clips.

JSON body: { q, limit? } — GET also supported with ?q=

curl

curl -s -X POST -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"rag vs mcp","limit":8}' \
  "https://www.youtubetimesearch.com/api/v1/answer"

JavaScript

await fetch(`https://www.youtubetimesearch.com/api/v1/answer`, {
  method: "POST",
  headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
  body: JSON.stringify({ q: "rag vs mcp", limit: 8 }),
});

Python

requests.post("https://www.youtubetimesearch.com/api/v1/answer", json={"q": "rag vs mcp"}, headers={"Authorization": f"Bearer {api_key}"})