Skip to content
Pellio
All integrations

REST API

Build on Pellio with a documented REST API.

What you can do

  • Upload videos straight to storage, with resumable uploads in 16 MB parts for large files.
  • Import a video from a link to a file.
  • Read and manage your library and webhooks from your own code.
  • Pull your analytics into a dashboard, spreadsheet or data warehouse (see Analytics below).
  • Give each key only the access it needs: Read only, Read & write videos or Admin.

Analytics

Any key, including Read only, can read your analytics. Every period is days (the last N days, today included) or from and to dates (YYYY-MM-DD, both included).

  • GET /v1/stats: totals, plays per day, every video, top pages and UTM campaigns for the workspace, a folder or a tag. ?format=csv for a spreadsheet.
  • GET /v1/videos/{id}/stats: one video, with its audience retention, completion, countries and devices.
  • GET /v1/analytics/sessions: every view, oldest first, up to 1,000 at a time. Pass the next value back as after to get the next page. Each view has the viewer (when known), how much they watched, whether they finished, country, device, page, UTM tags and what they clicked or submitted.
  • GET /v1/analytics/viewer?email=…: everything one person watched, per video, with all their sessions combined.
  • POST /v1/analytics/report: a custom report (group by and numbers, as in Analytics → Reports), and GET /v1/analytics/reports/{id}/run runs a report your team saved there.
  • GET /v1/analytics/compare?videos=… and GET /v1/analytics/live: compare videos, and who’s watching right now.

Set it up

  1. In Pellio, go to Settings → Developers. You need to be an owner or admin.
  2. Create a key: give it a name and choose its Access.
  3. Copy the key. It’s shown once, so store it somewhere safe.
  4. Send it as a bearer token: curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
  5. To upload, call POST /v1/videos/uploads, PUT the file to the returned URL, then call POST /v1/videos/{id}/complete. A video.ready webhook tells you when it’s processed.

Good to know

  • Every endpoint is in the API reference, and the OpenAPI document is at https://api.pellio.io/v1/openapi.json.
  • Files must be video or audio, up to 20 GB. Upload URLs are valid for 6 hours.
  • Each key can make 600 requests a minute and 30 imports a minute. A 429 response means slow down and retry.
  • The key list shows when each key was last used. Revoke stops a key at once.
  • Needs the Standard plan or above.

Full guide: API keys.

More developers

Try Pellio with REST API.

Start free. Connect it in a few minutes.