ViralClaw API

type: service

description: Video captioning API for AI agents. Transform videos into viral shorts with styled captions.

header: X-API-Key

expiration: never

credit_unit: 1 credit = 1 minute of video


type: endpoint

method: GET

description: Check credit balance, plan, and rate limit


description: Full account info with API key details and today's usage


description: List available caption styles

Hormozi

description: Bold, impactful captions

MrBeast

description: High energy, colorful

TikTok

description: Glowing neon, trendy

Minimal

description: Clean, simple

Karaoke

description: Word-by-word highlight


description: Usage history with daily breakdown

type: int


method: POST

description: Add captions to a single video

content_type: multipart/form-data

type: string

description: URL of video to process (or upload via 'video' field)

type: file

description: Video file upload (alternative to video_url)

default: hormozi

enum: hormozi mrbeast tiktok minimal karaoke

description: Language code (e.g. en, pt, es)

description: URL to receive job completion callback

description: Token sent back in webhook header for verification

default: normal

enum: normal high

credits: 1 per minute of video (rounded up)


description: Full pipeline: long video to multiple viral shorts

description: URL of long video

description: Video file upload

description: Language code

description: Number of shorts to generate


description: Poll job status and get results


description: List your shorts (paginated)

enum: queued processing done failed


description: Get single short with signed download URL


method: DELETE

description: Delete a short


path: /health

description: API health check


type: errors

Bad request (invalid style, missing video, etc)

Invalid or missing API key

Insufficient credits

Feature not available on your plan

Job or short not found

Rate limit exceeded

Server error

detail: Human-readable error message


type: webhooks

description: POST callback when job completes

payload: Full job object including output_url

verification: webhook_token sent back in request header