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=csvfor 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 thenextvalue back asafterto 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), andGET /v1/analytics/reports/{id}/runruns a report your team saved there.GET /v1/analytics/compare?videos=…andGET /v1/analytics/live: compare videos, and who’s watching right now.
Set it up
- In Pellio, go to Settings → Developers. You need to be an owner or admin.
- Create a key: give it a name and choose its Access.
- Copy the key. It’s shown once, so store it somewhere safe.
- Send it as a bearer token:
curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…" - To upload, call
POST /v1/videos/uploads,PUTthe file to the returned URL, then callPOST /v1/videos/{id}/complete. Avideo.readywebhook 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
WebhooksGet signed HTTPS requests when videos are created, ready, failed, deleted or watched, and when leads come in.Player API and embedsEmbed with an iframe or the Pellio web component, control playback from your page and listen for player events.oEmbedPaste a Pellio share link into Workover or any oEmbed-aware editor and it turns into the Pellio player.



