The Glissed API

Make a video from any URL with one request. Use it from scripts, CI or the GitHub Action. The API is part of Pro and Team; create a key in Settings.

Authentication

Send your key as a bearer token. Keys start with gls_live_.

Authorization: Bearer gls_live_…

Make a video

POST /api/v1/videos. Only url is required; anything in settings overrides the defaults (the same options as the studio). Identical captures from the last 7 days are reused unless you pass fresh: true.

curl -X POST https://getglissed.app/api/v1/videos \
  -H "Authorization: Bearer $GLISSED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "device": "desktop",
    "title": "Launch day",
    "settings": {
      "aspect": "16:9",
      "resolution": "1080p",
      "duration": 12,
      "format": "mp4",
      "layout": "duo",
      "zoom": { "enabled": true, "strength": 1.35 },
      "cursor": { "enabled": true, "style": "arrow", "clicks": true }
    }
  }'
{ "id": "3332d863-…", "status": "processing", "url": "/api/v1/videos/3332d863-…" }

Check on it

GET /api/v1/videos/:id. Poll every few seconds. When status is done, video.download_url is valid for one hour.

{
  "id": "3332d863-…",
  "status": "done",
  "progress": 1,
  "video": {
    "download_url": "https://…/video.mp4?X-Amz-…",
    "width": 1920, "height": 1080, "duration": 12, "bytes": 13512345
  },
  "share_url": null
}

Settings reference

  • aspect: 16:9, 4:3, 1:1, 4:5, 9:16
  • resolution: 720p, 1080p, 1440p, 4k · fps: 24, 30, 60 · duration: 2–90 seconds
  • format: mp4, webm, gif · background: { type: 'gradient', preset: 'aurora' }, solid or transparent (WebM)
  • motion: constant, smooth, glide · pauses: [{ at: 0–1, duration }] · loop: none, pingpong
  • frame: none, browser-light, browser-dark, phone · layout: single, duo, trio
  • zoom, cursor, texts, branding, music, captureMode (snapshot or live)

GitHub Action

Make a video of every preview deploy. Add your key as the GLISSED_API_KEY secret.

# .github/workflows/glissed.yml
on: deployment_status
jobs:
  video:
    if: github.event.deployment_status.state == 'success'
    runs-on: ubuntu-latest
    steps:
      - uses: kindridstudio/glissed/integrations/github-action@main
        id: glissed
        with:
          api-key: ${{ secrets.GLISSED_API_KEY }}
          url: ${{ github.event.deployment_status.target_url }}
          settings: '{"aspect":"16:9","duration":10}'
      - run: echo "Video: ${{ steps.glissed.outputs.video-url }}"

Limits

Up to 120 captures and 40 exports an hour per account. Failed exports never count against you. Pages must be public; for signed-in pages, use the browser extension.