2026-11-11 · 5 min read

How to add captions to recruitment videos with an API

A film strip of hiring video scenes, the middle frame showing the captioned word HIRE
This image was generated with AI.

Recruitment video has a caption problem by default. Job ads get cut into clips for LinkedIn and Instagram, culture videos get embedded on career pages, and hiring managers send intro videos over email. Each platform shows that footage differently, and captions burned into the video travel with every copy. This guide shows how to add them with the caption.sh API instead of an editor.

Why recruiting teams caption

  • Candidates often encounter job videos while scrolling at work or on a commute, where reading along is easier than listening.
  • A job ad with the spoken pitch on screen can hold attention longer than a silent clip in a crowded feed, though results vary by audience.
  • Burned-in captions survive re-uploads: the same captioned file works on the career page, LinkedIn, and in an email attachment.
  • Captions make names, role titles, and application links visible to viewers who catch only a few seconds.

The workflow

caption.sh takes a source URL, transcribes the audio, and returns an MP4 with captions burned in. Submit a job, poll until it finishes, download the result.

import requests, time

API = "https://api.caption.sh/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

job = requests.post(
    f"{API}/videos",
    headers=HEADERS,
    json={
        "source_url": "https://your-cdn.example/culture-video.mp4",
        "options": {
            "font": "inter",
            "position": "bottom",
            "max_words": 4,
            "max_lines": 2,
            "highlight": True,
            "highlight_color": "#4ADE80",
        },
    },
).json()
job_id = job["job_id"]

for _ in range(120):
    job = requests.get(f"{API}/jobs/{job_id}", headers=HEADERS).json()
    if job["status"] in ("done", "error"):
        break
    time.sleep(5)

if job["status"] == "done":
    r = requests.get(f"{API}/jobs/{job_id}/result", headers=HEADERS,
                     allow_redirects=False)
    video_url = r.headers["Location"]

Jobs move through queued, awaiting_upload, running, then done or error, so poll until a terminal status. The result endpoint returns a 302 redirect; fetch it with redirects disabled and read the Location header. Results are stored for 24 hours, then deleted, so download right away.

Practical notes for recruiting content

  • Interview clips with several speakers transcribe like normal speech, but review names and job titles before publishing, since those are the words candidates search for.
  • Each job accepts up to 10 minutes. A longer culture film can be split into segments, with the per-minute cost summed across them.
  • If you hit a 429, the transcription throughput ceiling is reached. Wait and retry the same job instead of submitting duplicates.
  • At $0.10 per minute prepaid, a 90-second job ad costs about $0.15, so a full season of hiring content fits a small top-up.

Tradeoffs

Burned-in captions cannot be toggled, resized, or translated by the viewer. For career-page embeds where accessibility matters, keep the platform or player captions available alongside the burned-in version so viewers who need adjustable text still have it.

Back to all articles