2026-11-16 · 5 min read
How to add captions to travel videos with an API
Travel video is narration over ambience: a voice track explaining the itinerary while street noise, waves, and wind run underneath. Captions are how the story survives a silent scroll, and place names are exactly the words viewers want to read and search later. caption.sh adds them with an API call.
Where captions fit in travel content
- Destination guides where neighborhood names, restaurant names, and prices need to be readable.
- Itinerary videos where viewers screenshot the plan as it goes by.
- Hotel and tour walkthroughs where the voiceover carries the details.
- Short vertical cuts for Reels, TikTok, and Shorts pulled from longer vlogs.
The workflow
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/destination-guide.mp4",
"options": {
"font": "inter",
"position": "bottom",
"max_words": 4,
"max_lines": 2,
"highlight": True,
"highlight_color": "#38BDF8",
},
},
).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 run queued, awaiting_upload, running, then done or error; poll until a terminal status. The result endpoint answers 302, so read the Location header with redirects disabled. Results are stored for 24 hours, then deleted.
Place names and ambient audio
Foreign place names are the hardest words in travel audio for any transcription, and they are the words your audience cares about most. Plan a review pass on names before publishing. Field audio with wind and crowds under the voice also lowers accuracy; if your edit can duck the ambience under narration, caption that version.
Tradeoffs and cost
- Burned-in captions cannot be toggled, resized, or translated. Keep platform captions enabled for viewers who need adjustable text.
- Each job covers up to 10 minutes. Longer vlogs should be cut into segments, which is also how travel content performs best.
- A 429 means the transcription throughput ceiling is reached. Wait and retry rather than submitting duplicates.
- At $0.10 per minute prepaid, captioning a 6-minute guide costs $0.60.