PageToVid API

Authentication

Create an API key in your account, then send it as a Bearer token. Keep it secret — it spends your credits.

http
Authorization: Bearer cp_live_xxxxxxxxxxxxxxxx

Base URL: https://pagetovid.com · 1 credit = 1 rendered video.

Create a video

POST /api/v1/videos — returns immediately with an id; rendering runs async.

curl
curl -X POST https://pagetovid.com/api/v1/videos \
  -H "Authorization: Bearer $PAGETOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "goal": "ad",          // explainer | ad | demo | tutorial
    "aspect": "16:9",      // 16:9 | 9:16 | 1:1
    "language": "en",
    "targetSeconds": 35,
    "subtitles": true
  }'

Response (202):

json
{
  "id": "cmq…",
  "status": "analyzing",
  "statusUrl": "https://pagetovid.com/api/v1/videos/cmq…"
}

Get a video / poll status

GET /api/v1/videos/:id — poll until status: "done".

json
{
  "id": "cmq…",
  "status": "done",          // analyzing | scripting | recording | voicing | rendering | done | error
  "progress": 100,
  "videoUrl":  "https://pagetovid.com/media/cmq…/video.mp4",
  "posterUrl": "https://pagetovid.com/media/cmq…/scene-2.png",
  "subtitleUrl": "https://pagetovid.com/media/cmq…/subtitles.vtt",
  "durationMs": 41000,
  "width": 1920, "height": 1080,
  "og": { "og:video": "…", "og:image": "…", "og:video:type": "video/mp4", … }
}

Automate it

Generate + wait, in any language.

javascript
const KEY = process.env.PAGETOVID_API_KEY;
const create = await fetch("https://pagetovid.com/api/v1/videos", {
  method: "POST",
  headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://your-site.com", goal: "ad" }),
}).then((r) => r.json());

let v;
do {
  await new Promise((r) => setTimeout(r, 5000));
  v = await fetch(create.statusUrl, { headers: { Authorization: `Bearer ${KEY}` } }).then((r) => r.json());
} while (v.status !== "done" && v.status !== "error");

console.log(v.videoUrl, v.posterUrl, v.og);

python
import os, time, requests
KEY = os.environ["PAGETOVID_API_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

r = requests.post("https://pagetovid.com/api/v1/videos", headers=H, json={"url": "https://your-site.com", "goal": "ad"}).json()
while True:
    time.sleep(5)
    v = requests.get(r["statusUrl"], headers=H).json()
    if v["status"] in ("done", "error"):
        break
print(v["videoUrl"], v["posterUrl"], v["og"])

Errors & limits

• 401 — invalid or missing API key.
• 402 — out of credits. Top up on pricing.
• 400 — invalid input (a url is required).
• Rendering is async — it takes a few minutes; poll the status URL.
• CORS is enabled, so you can call it straight from the browser.