API Reference

Starts a video from a product's landing page. Only url is required. Unknown fields are refused, so a typo isn't ignored.

Uploads (screenshots, reference video, recordings) and GitHub repos are only available in the app for now.

curl -X POST https://demoeditor.com/api/v1/videos \
  -H "Authorization: Bearer $DEMOEDITOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com", "type": "teaser", "description": "Show the onboarding in 20 seconds" }'

It answers as soon as the video is saved, in about a second (the landing page is read first). 201:

{
  "id": "…",
  "title": "Example Domain",
  "status": "starting",
  "webUrl": "https://demoeditor.com/app/<project>/video?run=…"
}

The video then starts in the background and is made on its own. If it can't start, following it reports status: "failed" with the reason in error. When the platform as a whole is busy, the call still answers 201 with "status": "queued": the video waits in line (it is already charged to the pack) and starts when a place frees up, usually within minutes; following it shows its position. A video that waits more than 6 hours fails and is given back.

Also refused with 402 (no videos left) or 429 (too many in progress).

Language codes: en (English), af (Afrikaans), ar (Arabic), hy (Armenian), as (Assamese), ast (Asturian), az (Azerbaijani), id (Bahasa Indonesia), be (Belarusian), bn (Bengali), bs (Bosnian), bg (Bulgarian), my (Burmese), yue (Cantonese), ca (Catalan), ceb (Cebuano), hr (Croatian), cs (Czech), da (Danish), nl (Dutch), et (Estonian), fil (Filipino), fi (Finnish), fr (French), gl (Galician), ka (Georgian), de (German), el (Greek), gu (Gujarati), ha (Hausa), he (Hebrew), hi (Hindi), hu (Hungarian), is (Icelandic), ga (Irish), it (Italian), ja (Japanese), jv (Javanese), kn (Kannada), kk (Kazakh), ko (Korean), ky (Kyrgyz), lv (Latvian), ln (Lingala), lt (Lithuanian), lb (Luxembourgish), mk (Macedonian), ms (Malay), ml (Malayalam), mt (Maltese), zh (Mandarin Chinese), mi (Māori), mr (Marathi), mn (Mongolian), ne (Nepali), no (Norwegian), oc (Occitan), or (Odia), ps (Pashto), fa (Persian), pl (Polish), pt (Portuguese), pa (Punjabi), ro (Romanian), ru (Russian), sr (Serbian), sd (Sindhi), sk (Slovak), sl (Slovenian), so (Somali), es (Spanish), sw (Swahili), sv (Swedish), tg (Tajik), ta (Tamil), te (Telugu), th (Thai), tr (Turkish), uk (Ukrainian), ur (Urdu), uz (Uzbek), vi (Vietnamese), cy (Welsh), yo (Yoruba).

One video's progress. Poll about every 30 seconds until status is done or failed, or just share the webUrl and let your team watch.

{
  "id": "…",
  "title": "Example Domain",
  "status": "running",
  "phase": "storyboard",
  "webUrl": "https://demoeditor.com/app/<project>/video?run=…",
  "videoUrl": "https://demoeditor.com/api/v1/videos/…/video",
  "inputs": { "url": "https://example.com/", "type": "teaser", "description": "…" },
  "note": "Use this one for the launch post",
  "startedAt": "2026-10-20T09:00:00.000Z",
  "updatedAt": "2026-10-20T09:04:12.000Z"
}

videoUrl appears once a cut exists; note is the video's shared note, when it has one. The creator also gets a “your video is ready” email.

The latest cut as video/mp4 (an attachment). 404 until it exists. It needs the bearer token, so fetch it from your server:

curl -L https://demoeditor.com/api/v1/videos/$VIDEO_ID/video \
  -H "Authorization: Bearer $DEMOEDITOR_TOKEN" \
  -o video.mp4

The token user's videos in the project, newest first. Use Follow it for one video's status.

{
  "items": [
    {
      "id": "…",
      "title": "Example Domain",
      "webUrl": "…",
      "posterUrl": "…",
      "variant": { "label": "a", "groupId": "…" },
      "createdAt": "2026-10-20T09:00:00.000Z"
    }
  ]
}

posterUrl is there once the video has a poster; variant only for a video in a pair.

Saves the video's shared note, the one your team sees on its page. There is one note per video: it replaces any existing one, and an empty or whitespace-only body clears it. Free: no video is spent.

curl -X PUT https://demoeditor.com/api/v1/videos/$VIDEO_ID/note \
  -H "Authorization: Bearer $DEMOEDITOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Use this one for the launch post" }'

{ "note": "Use this one for the launch post" }

note is null once cleared. 404 for a video that isn't one of the token user's own in the token's project. The note is also part of Follow it.

Version B of a finished video, for an A/B test, made after the fact. B is a copy of the video's latest version where only the opening (the first shot or two) changes. It takes 1 video from a paid video pack (never the free trial), and from then on the two are a pair like those made with variants: 2.

curl -X POST https://demoeditor.com/api/v1/videos/$VIDEO_ID/variant \
  -H "Authorization: Bearer $DEMOEDITOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "angle": "Lead with the price" }'

201, with B's id. B is a video of its own: follow it by that id.

{
  "id": "<B>",
  "status": "running",
  "webUrl": "…",
  "variant": { "label": "b", "groupId": "<A>", "otherId": "<A>" }
}

• 403: the token's user didn't make this video. 404: not in the token's project.
• 409: the video isn't finished, is being worked on, or is already one of a pair.
• 402: no paid video pack with videos left. 429: the project has 3 videos in progress, or the organization is at its limit.

If anything fails along the way, B is dropped, its video is given back and A is not paired.

A finished video in another language. The new video is version B of a language pair, as made with languages: the same shots and look, with the voiceover lines and on-screen text translated, voiced in the new language and re-timed to the new lines. It takes 1 video from a paid video pack (never the free trial).

curl -X POST https://demoeditor.com/api/v1/videos/$VIDEO_ID/language \
  -H "Authorization: Bearer $DEMOEDITOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "language": "ro" }'

201, with the languages in variant (the video's own first):

{
  "id": "<B>",
  "status": "running",
  "webUrl": "…",
  "variant": { "label": "b", "groupId": "<A>", "otherId": "<A>", "languages": ["en", "ro"] }
}

Same refusals as Variant of a video. A video that is already one of a pair can't get another language. Both videos then report variant.languages when followed.

What the token's organization has left to make videos with. Packs are shared by all the organization's projects.

{
  "videosLeft": 7,
  "packs": [
    {
      "name": "Launch",
      "plan": "launch",
      "size": 10,
      "used": 3,
      "remaining": 7,
      "status": "active",
      "purchasedAt": "2026-10-01T08:00:00Z",
      "expiresAt": "2026-11-01T08:00:00Z"
    }
  ],
  "inProgress": { "org": 1, "orgLimit": 3, "project": 1, "projectLimit": 3 }
}