Skip to main content

API Endpoints

Complete API reference for Boosta.

POST /api/v1/jobs

Submit a video for processing.

Request

curl -X POST https://boosta.pro/api/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"video_url": "https://youtube.com/watch?v=xxx",
"video_type": "conversation",
"config_name": "My Config"
}'

Parameters

ParameterRequiredDescription
video_urlYesYouTube URL or direct video link
video_typeYesType of video content (see Video Types). Determines AI analysis approach.
config_nameNoName of your saved config from dashboard. Uses default settings if omitted.

Response

{
"job_id": "job_1234567890_abc123",
"status": "queued",
"message": "Job submitted successfully"
}

GET /api/v1/jobs/:job_id

Check status of a specific job.

Request

curl https://boosta.pro/api/v1/jobs/job_1234567890_abc123 \
-H "Authorization: Bearer YOUR_API_KEY"

Response (Processing)

{
"job_id": "job_1234567890_abc123",
"status": "processing",
"progress": 45,
"step": "Creating clips..."
}

Response (Completed)

{
"job_id": "job_1234567890_abc123",
"status": "completed",
"title": "Video Title",
"clips_count": 7,
"clip_urls": [
"https://cdn.boosta.pro/.../clip_001.mp4",
"https://cdn.boosta.pro/.../clip_002.mp4"
]
}

GET /api/v1/jobs

List your completed jobs.

Request

curl https://boosta.pro/api/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

ParameterDefaultDescription
statuscompletedFilter by status (e.g., completed, all)
limit50Limit results (default 50)

Returns all completed jobs with titles and clip URLs. Add ?status=all for all statuses, ?limit=N to limit results.

Response

{
"jobs": [
{
"job_id": "job_xxx",
"title": "Video Title",
"clips_count": 7
}
],
"count": 1
}

GET /api/v1/usage

Check your credit balance.

Request

curl https://boosta.pro/api/v1/usage \
-H "Authorization: Bearer YOUR_API_KEY"

Response

{
"credits_remaining": 450,
"credits_total": 500,
"plan": "Pro"
}