Quickstart
Create a key, send one request, read the transcript.
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"{
"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/extractwith{"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.