Introducing the ReedTV API — Automate Your Video Workflow with Scoped API Keys
ReedTV now has a proper developer API. If you want to automate uploads, keep your video library in sync with another system, pull analytics into your own dashboard, or script anything you'd normally do by hand in the portal, you can now do it with a secure, scoped API key.
What you can do
- Manage videos — list, fetch, create (with an upload URL), update metadata, and delete videos.
- Sync your BYOA account — list the videos in your own Cloudflare Stream account and import them into ReedTV.
- Pull analytics — account-wide and per-video view stats.
- Generate fresh embed links — mint a new re-embed URL for any video on demand.
- Captions & storage — manage captions and check your storage usage and plan.
Scoped keys, by design
Every API key is limited to the scopes you grant it. Pick exactly what a key can do when you create it:
| Scope | Grants |
|---|---|
videos:read | List/read videos, storage usage, captions, fresh links |
videos:write | Create, update, delete videos; manage captions; copy to shared |
vendors:read | List your connected Cloudflare Stream (BYOA) accounts and their videos |
vendors:write | Connect, verify, and sync BYOA accounts |
analytics:read | Read view analytics |
Keys can only reach the documented public API. They cannot touch billing, account settings, or admin — and they only ever see your own data. Each key is shown once when created, can carry an optional expiry, and can be revoked at any time.
Getting started
- Open the Developer page in your ReedTV portal.
- Create a key, choose its scopes, and copy it (it's shown only once).
- Send it as a bearer token:
Authorization: Bearer rtv_live_…
curl -s "https://reedtv.com/api/videos?limit=10" \ -H "Authorization: Bearer $REEDTV_API_KEY"
Full docs — for humans and AI agents
Browse the complete reference at reedtv.com/developer. We also publish a machine-readable Markdown version for AI coding agents, downloadable from the docs page and served at /llms.txt — point your assistant at it and it can write the integration for you.