Video Transcription API Documentation

https://soscripted.com/api/public

Authorization: Bearer sk_your_api_key_here

POST /api/public/transcribe HTTP/1.1
Host: soscripted.com
Authorization: Bearer sk_your_api_key_here
Content-Type: application/json

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

{
  "ok": true,
  "caption": {
    "text": "Full transcript text here...",
    "segments": [
      { "start": 0.0, "end": 2.5, "text": "Hello world" },
      { "start": 2.5, "end": 5.0, "text": "This is a transcript" }
    ]
  }
}

event: progress
data: {"stage":"downloading","pct":10}

event: progress
data: {"stage":"transcribing","pct":50}

event: final
data: {"ok":true,"caption":{"text":"...","segments":[...]}}

event: done
data: {"ok":true}

curl "https://soscripted.com/api/public/library?search=marketing&limit=10" \
  -H "Authorization: Bearer sk_your_api_key_here"

# Get full JSON
curl "https://soscripted.com/api/public/library/clx123abc" \
  -H "Authorization: Bearer sk_your_api_key_here"

# Get plain text only
curl "https://soscripted.com/api/public/library/clx123abc?format=txt" \
  -H "Authorization: Bearer sk_your_api_key_here"

# Get SRT subtitles
curl "https://soscripted.com/api/public/library/clx123abc?format=srt" \
  -H "Authorization: Bearer sk_your_api_key_here"

POST /api/public/batch-import HTTP/1.1
Host: soscripted.com
Authorization: Bearer sk_your_api_key_here
Content-Type: application/json

{
  "url": "https://www.youtube.com/@MrBeast",
  "collectionId": "clx456def",
  "maxVideos": 50,
  "autoSave": true
}

curl "https://soscripted.com/api/public/batch-import?page=1&limit=20" \
  -H "Authorization: Bearer sk_your_api_key_here"

curl "https://soscripted.com/api/public/batch-import/batch_abc123" \
  -H "Authorization: Bearer sk_your_api_key_here"

POST /api/public/webhooks HTTP/1.1
Host: soscripted.com
Authorization: Bearer sk_your_api_key_here
Content-Type: application/json

{
  "url": "https://your-app.com/webhooks/soscripted",
  "events": ["transcript.completed", "batch.completed"]
}

curl "https://soscripted.com/api/public/webhooks" \
  -H "Authorization: Bearer sk_your_api_key_here"

curl -X PATCH "https://soscripted.com/api/public/webhooks/wh_abc123" \
  -H "Authorization: Bearer sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"active": false}'

curl -X DELETE "https://soscripted.com/api/public/webhooks/wh_abc123" \
  -H "Authorization: Bearer sk_your_api_key_here"

curl -X POST "https://soscripted.com/api/public/webhooks/wh_abc123/test" \
  -H "Authorization: Bearer sk_your_api_key_here"

curl "https://soscripted.com/api/public/webhooks/wh_abc123/deliveries?page=1&limit=20" \
  -H "Authorization: Bearer sk_your_api_key_here"

POST /api/public/monitors HTTP/1.1
Host: soscripted.com
Authorization: Bearer sk_your_api_key_here
Content-Type: application/json

{
  "channelUrl": "https://www.youtube.com/@mkbhd",
  "collectionId": "clx456def",
  "checkInterval": "daily",
  "videoTypes": ["video"],
  "monthlyBudget": 30
}

curl "https://soscripted.com/api/public/monitors?page=1&limit=20" \
  -H "Authorization: Bearer sk_your_api_key_here"

curl -X PATCH "https://soscripted.com/api/public/monitors/mon_abc123" \
  -H "Authorization: Bearer sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"checkInterval": "hourly", "monthlyBudget": 50}'

curl -X DELETE "https://soscripted.com/api/public/monitors/mon_abc123" \
  -H "Authorization: Bearer sk_your_api_key_here"

import crypto from "crypto";

function verifyWebhook(body, signature, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(body, "utf-8")
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// In your webhook handler:
app.post("/webhooks/soscripted", (req, res) => {
  const signature = req.headers["x-soscripted-signature"];
  const isValid = verifyWebhook(req.rawBody, signature, WEBHOOK_SECRET);

  if (!isValid) {
    return res.status(401).json({ error: "Invalid signature" });
  }

  const event = req.body;
  console.log("Event type:", event.event);
  // Handle the event...

  res.status(200).json({ received: true });
});

{
  "event": "transcript.completed",
  "timestamp": "2026-02-24T12:05:00Z",
  "data": {
    "jobId": "job_abc123",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Video Title",
    "platform": "youtube",
    "transcriptId": "clx789ghi",
    "duration": 245,
    "wordCount": 1830,
    "source": "api",
    "batchId": null,
    "monitorId": null
  }
}

{
  "event": "transcript.failed",
  "timestamp": "2026-02-24T12:05:00Z",
  "data": {
    "jobId": "job_def456",
    "url": "https://www.youtube.com/watch?v=invalid",
    "platform": "youtube",
    "error": "Video not found or is private",
    "source": "api",
    "batchId": null,
    "monitorId": null
  }
}

{
  "event": "batch.completed",
  "timestamp": "2026-02-24T14:30:00Z",
  "data": {
    "batchId": "batch_abc123",
    "sourceType": "youtube_channel",
    "sourceName": "MrBeast",
    "totalVideos": 50,
    "completedVideos": 48,
    "failedVideos": 2,
    "creditsUsed": 48
  }
}

{
  "event": "monitor.new_video",
  "timestamp": "2026-02-24T15:00:00Z",
  "data": {
    "monitorId": "mon_abc123",
    "channelName": "MKBHD",
    "platform": "youtube",
    "videoUrl": "https://www.youtube.com/watch?v=newvideo",
    "videoTitle": "New Video Title",
    "publishedAt": "2026-02-24T14:55:00Z",
    "autoTranscribe": true,
    "jobId": "job_ghi789"
  }
}

const response = await fetch("https://soscripted.com/api/public/transcribe", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  }),
});

const data = await response.json();

if (data.ok) {
  console.log("Transcript:", data.caption.text);
} else {
  console.error("Error:", data.error);
}

const response = await fetch("https://soscripted.com/api/public/transcribe", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_your_api_key_here",
    "Content-Type": "application/json",
    "Accept": "text/event-stream",
  },
  body: JSON.stringify({
    url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  }),
});

const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split("\n");
  buffer = lines.pop() || "";

  for (const line of lines) {
    if (line.startsWith("data: ")) {
      const data = JSON.parse(line.slice(6));
      console.log("Event:", data);
    }
  }
}

import requests

response = requests.post(
    "https://soscripted.com/api/public/transcribe",
    headers={
        "Authorization": "Bearer sk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
    timeout=600,
)

data = response.json()

if data.get("ok"):
    print("Transcript:", data["caption"]["text"])
else:
    print("Error:", data.get("error"))

import requests
import json

response = requests.post(
    "https://soscripted.com/api/public/transcribe",
    headers={
        "Authorization": "Bearer sk_your_api_key_here",
        "Content-Type": "application/json",
        "Accept": "text/event-stream",
    },
    json={"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"},
    stream=True,
)

for line in response.iter_lines(decode_unicode=True):
    if line.startswith("data: "):
        data = json.loads(line[6:])
        print("Event:", data)
        if "caption" in data:
            print("Transcript:", data["caption"]["text"])