Build private streaming archives, not noisy video feeds.

How to get an API key

1. Sign in to ClosedCast.
2. Open Settings.
3. Find API Access.
4. Turn API access on.
5. Copy your API token.

Treat your API token like a password. If you regenerate it, Zapier and other integrations using the old token must be updated.

Authorization header

Authorization: Bearer cc_live_YOUR_API_TOKEN

Standard JSON headers

Accept: application/json
Content-Type: application/json

Open-ended text search

Pass a word or phrase through the q parameter to search all videos accessible to the authenticated user.

curl.exe --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json" ^
  --data-urlencode "q=vacation"

Searches are case-insensitive and can match:

• Video title
• Video description
• Tags
• Collection name

Search a phrase

Use --data-urlencode when the search contains spaces, punctuation, braces, or other characters that should be URL encoded.

curl.exe --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json" ^
  --data-urlencode "q=family vacation"

Only an exact reserved command such as {all} activates command mode. A query such as family {all} is treated as a normal text search.

List all accessible videos

curl.exe --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json" ^
  --data-urlencode "q={all}"

List owned videos

curl.exe --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json" ^
  --data-urlencode "q={owned}"

List shared videos

curl.exe --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json" ^
  --data-urlencode "q={shared}"

List recently updated videos

curl.exe --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json" ^
  --data-urlencode "q={recent}"

Query parameters

Result ordering and access

• Results are ordered by most recently updated first.
• Duplicate videos are removed before pagination.
• Inactive and deleted videos are excluded.
• Pending, revoked, and expired shares are excluded.
• Shared collection access includes videos inside that collection.

Search discovery does not automatically change permissions on other API endpoints. A video returned by Search must still pass the authorization rules enforced by the requested playback, detail, download, or update endpoint.

Invalid search term

Normal text searches must contain at least two characters.

curl.exe -i --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  --data-urlencode "q=a"

HTTP/1.1 400 Bad Request

{
  "ok": false,
  "version": "v1",
  "message": "Search term must be at least two characters."
}

Invalid API token

curl.exe -i --get "https://closedcast.com/APIv1/Search" ^
  -H "Authorization: Bearer invalid_token" ^
  --data-urlencode "q={all}"

HTTP/1.1 401 Unauthorized

{
  "ok": false,
  "version": "v1",
  "message": "Invalid API token."
}

Upload from Zapier or cloud storage

Use UploadVideoFromUrl when a prior Zap step gives you a downloadable file URL from Google Drive, Dropbox, OneDrive, Box, SharePoint, Gmail Attachments, or Google Forms.

curl.exe -X POST "https://closedcast.com/APIv1/UploadVideoFromUrl" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Content-Type: application/json" ^
  -d "{\"Title\":\"Sunday Service\",\"Description\":\"Uploaded from Zapier\",\"CategoryID\":\"CATEGORY_ID\",\"FileUrl\":\"https://example.com/video.mp4\"}"

Check status and receive a signed URL

Use mode=json for API clients, Zapier, command-line tools, and applications that want to inspect download status before retrieving the file. ClosedCast authenticates the request, verifies tenant access, and asks Cloudflare to prepare the MP4 when needed.

curl.exe -i "https://closedcast.com/APIv1/Download?id=VIDEO_ID&mode=json" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Accept: application/json"

Processing response

HTTP/1.1 202 Accepted
Retry-After: 10

{
  "ok": true,
  "version": "v1",
  "status": "processing",
  "download": {
    "VideoID": "VIDEO_ID",
    "Title": "Family Video",
    "Format": "video/mp4",
    "PercentComplete": 42,
    "RetryAfterSeconds": 10
  }
}

Download the file through a redirect

Omit mode=json and use a client that follows redirects. When the MP4 is ready, ClosedCast returns 302 Found with a short-lived Cloudflare URL. Cloudflare then delivers the file directly, so ClosedCast does not proxy the video bytes.

curl.exe -L "https://closedcast.com/APIv1/Download?id=VIDEO_ID" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  --progress-bar ^
  -o "closedcast-video.mp4"

Ready JSON response

{
  "ok": true,
  "version": "v1",
  "status": "ready",
  "download": {
    "VideoID": "VIDEO_ID",
    "Title": "Family Video",
    "FileName": "FamilyVideo.mp4",
    "Format": "video/mp4",
    "Url": "https://customer.cloudflarestream.com/SIGNED_TOKEN/downloads/default.mp4",
    "ExpiresUtc": "2026-07-13T18:30:00Z"
  }
}

Refresh processing status

Videos usually move from processing to ready. Use RefreshVideo or the scheduled processing refresh job to keep MongoDB synchronized with Cloudflare.

curl.exe -X POST "https://closedcast.com/APIv1/RefreshVideo" ^
  -H "Authorization: Bearer YOUR_API_TOKEN" ^
  -H "Content-Type: application/json" ^
  -d "{\"VideoID\":\"VIDEO_ID\"}"