Skip to content

Quickstart

Create a key, send one request, read the transcript.

View as Markdown

1. Create a key. Sign in, open API keys and create one. New accounts get 100 free credits, no card.

2. Send a request with the key in CLEANSCRIPT_API_KEY:

3. Read the result. sections holds the transcript as paragraphs with their times and a link to each moment; add include: ["text"] for it as one plain string too. This 4-minute video costs 1 credit, and the same request again within 6 hours is free.

export CLEANSCRIPT_API_KEY="<key>"
curl -G https://api.cleanscript.ai/v1/transcript \
  -H "Authorization: Bearer $CLEANSCRIPT_API_KEY" \
  --data-urlencode "url=https://youtu.be/jwnez8HdN7E"
Response (shortened)
{
  "post": { "platform": "youtube", "duration": 259.0 },
  "language": "en",
  "source": "auto",
  "text": null,
  "sections": [{
    "title": "Microsoft's quantum breakthrough",
    "start": 2.19,
    "end": 58.11,
    "url": "https://youtu.be/jwnez8HdN7E?t=2",
    "paragraphs": [{ "start": 2.19, "end": 58.11, "text": "…" }]
  }],
  "warnings": []
}

Next

  • Ask for fields instead of text: POST /v1/extract with {"url": "…", "prompt": "What does it say about pricing?"}. See Extract fields.
  • Use it from Claude, ChatGPT, Cursor or a coding agent: Agents & MCP.
  • Every parameter and field: API reference.