{"info":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","description":"

Upscale, sharpen, and restore video through a single API call.

\n

Privacy by design: we never train on your data, never sell it, and auto-delete it on a schedule you control (with a signed deletion certificate on the Secure tier). Built for teams that handle sensitive footage — legal, insurance, real estate, investigations, healthcare.

\n

Quick start

\n
    \n
  1. Get a key at https://api.bettervideo.io/developers (a sandbox bv_test_… key is free and instant).
    2. \n
  2. Set the collection variable api_key to your key.
    3. \n
  3. Run Submit a video → Get job status (poll until done) → Get download URL.
    4. \n
\n

Sandbox keys (bv_test_…) run a free mock lane — no GPU, no charges — and mirror the live lifecycle. Switch to a bv_live_… key for real jobs.

\n

Docs: https://api.bettervideo.io/api/docs · Terms: https://api.bettervideo.io/api/terms

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"56224993","collectionId":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","publishedId":"2sBXwyGSGx","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-28T04:11:06.000Z"},"item":[{"name":"Validate key & account info","id":"b63ebc62-b71b-44f4-aeea-16db45b9a81d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.bettervideo.io/v1/me","description":"

Returns your plan, credit balance, sandbox flag, limits, and per-minute pricing. Handy as an auth/health check.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["me"],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"b63ebc62-b71b-44f4-aeea-16db45b9a81d"},{"name":"Submit a video (Standard, 1080p)","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Auto-save the new job id so the next requests just work.","if (pm.response.code === 201) {"," pm.collectionVariables.set('job_id', pm.response.json().id);","}"],"id":"20f085cf-30be-441e-86ef-d0f0f7c81f44"}}],"id":"e1fd41d5-1240-4eb8-9a12-91016a1dd9d7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"video_url\": \"https://media.w3.org/2010/05/sintel/trailer.mp4\",\n \"resolution\": \"1080p\",\n \"webhook_url\": \"https://your-app.com/hooks/bettervideo\"\n}"},"url":"https://api.bettervideo.io/v1/jobs","description":"

Submit a public video URL for enhancement. Billed per minute of detected duration. Returns 201 with a job; poll its status or wait for the webhook. The test script saves the job id to .

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["jobs"],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"e1fd41d5-1240-4eb8-9a12-91016a1dd9d7"},{"name":"Submit a video (Secure tier, 4K)","event":[{"listen":"test","script":{"type":"text/javascript","exec":["if (pm.response.code === 201) {"," pm.collectionVariables.set('job_id', pm.response.json().id);","}"],"id":"7c0ef1c2-4ed4-4388-b76a-506dc67358e1"}}],"id":"0b9677da-4e74-4730-bdb5-eb02d1bd8b54","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"video_url\": \"https://media.w3.org/2010/05/sintel/trailer.mp4\",\n \"resolution\": \"4k\",\n \"secure\": true\n}"},"url":"https://api.bettervideo.io/v1/jobs","description":"

The optional \"secure\": true field upgrades THIS job to the Secure tier (2× price + a signed deletion certificate), overriding your account default. One key can mix Standard and Secure per job.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["jobs"],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"0b9677da-4e74-4730-bdb5-eb02d1bd8b54"},{"name":"Get job status","id":"678c27a9-757b-4a41-b0b2-ae8d57a19a0f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.bettervideo.io/v1/jobs/","description":"

Poll until status is done (or error). Lifecycle: queued → running → done.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["jobs",""],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"678c27a9-757b-4a41-b0b2-ae8d57a19a0f"},{"name":"Get download URL (enhanced video)","id":"e49c5f13-a610-49de-9040-76d0ea2aa1c8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.bettervideo.io/v1/jobs//result","description":"

Returns a time-limited signed download_url for the enhanced video once the job is done.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["jobs","","result"],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"e49c5f13-a610-49de-9040-76d0ea2aa1c8"},{"name":"Delete job data (on demand)","id":"dd8496c7-bfcb-4551-bd2b-2e2b90ea9bcd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.bettervideo.io/v1/jobs/","description":"

Permanently deletes the original + enhanced files. On the Secure tier the response includes a signed deletion certificate. (Files also auto-delete after your retention window.)

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["jobs",""],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"dd8496c7-bfcb-4551-bd2b-2e2b90ea9bcd"},{"name":"Get deletion certificate (Secure tier)","id":"50cbeff5-749a-415f-9e39-580b33f8ce68","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.bettervideo.io/v1/jobs//deletion-certificate","description":"

Secure tier: retrieve the signed, tamper-evident proof that a deleted job's files were removed.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["jobs","","deletion-certificate"],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"50cbeff5-749a-415f-9e39-580b33f8ce68"},{"name":"Get audit log (Secure tier)","id":"e0302987-f85e-41ae-a4dc-5e8a422e5ec1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.bettervideo.io/v1/audit-log","description":"

Secure tier: recent account events (job created/completed/deleted, recharges) for your records.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]},"isInherited":true,"source":{"_postman_id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","id":"08836dbb-01db-44c7-ba74-d0fcd9ca96b8","name":"BetterVideo API — Privacy-First Video Enhancement","type":"collection"}},"urlObject":{"path":["audit-log"],"host":["https://api.bettervideo.io/v1"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0302987-f85e-41ae-a4dc-5e8a422e5ec1"}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"bv_test_YOUR_SANDBOX_KEY"}]}},"variable":[{"key":"base_url","value":"https://api.bettervideo.io/v1"},{"key":"api_key","value":"bv_test_YOUR_SANDBOX_KEY"},{"key":"job_id","value":""}]}