Credits & limits

Credits

New accounts get 100 free credits, no card. After that, buy a pack in the dashboard; credits are valid for 12 months and add to your balance.

What a request costs

• Transcript: 1 credit per started 10 minutes of video: an 11-minute video is 2 credits.
• Fields (/v1/extract): 3 credits per started 10 minutes, the transcript included.
• Posts without captions: transcribed for 1 credit per started minute instead: a 45-second Reel is 1 credit.
• A translation the platform doesn't provide (into language): 1 credit more per started 10 minutes.
• On-screen text alongside speech: 1 credit more. For a post without speech it is the transcript.
• Creator posts (/v1/posts): 1 credit per call.
• Account (/v1/account): free.

Free, always: any request that fails. Asking again for the same thing within 6 hours is free. If you got this post's transcript in that time, asking for its fields costs only the fields. Asking again after a result with an incomplete or uncorrected warning runs the request again in full and is charged again. Every response says what it used in X-Credits-Used and what is left in X-Credits-Remaining. With no credits left, every request except /v1/account is insufficient_credits, even a free repeat.

Limits

• Requests a minute: set per account, 10 for new accounts; yours is rate_limit_per_minute in GET /v1/account. Over it you get rate_limited with Retry-After. Need more? Write to mohamed@messaad.dev.
• Unavailable posts and profiles: 30 an hour. Requests that end in video_unavailable, author_not_found or source_unavailable are free, but past 30 in an hour you get rate_limited until the hour is up. Asking again within 30 minutes for a post or profile that doesn't exist returns the same 404 and doesn't count.
• Post length: up to 2 hours. Posts without captions are transcribed up to 15 minutes.
• Time: a request answers within 120 seconds, or returns timeout.
• Size: request body up to 128 KB, schema up to 32 KB, response up to 8 MB.
• Creator posts: up to 30 per call on YouTube (videos, not Shorts), 35 on TikTok, 12 on Instagram.

Errors

Every error has the same shape. code is stable; message says what happened in words you can show; param names the field at fault; details carries data you can act on. Quote request_id when you contact us.

{
  "error": {
    "code": "insufficient_credits",
    "message": "This request needs 1 credit and the account has 0 left. Buy more at https://cleanscript.ai/pricing.",
    "details": {
      "credits_remaining": 0,
      "credits_required": 1,
      "top_up_url": "https://cleanscript.ai/pricing"
    }
  },
  "request_id": "5f0c7d1e-0b7a-4a39-9c1e-3c1f2b8f6a10"
}