# PeerTube

**Canonical:** https://apis.io/providers/peertube/  
**Website:** https://joinpeertube.org/  
**APIs profiled:** 54

PeerTube is a free, decentralized, and federated video hosting platform developed by Framasoft as an open-source alternative to centralized video services like YouTube. It enables anyone to self-host a video platform that federates with other instances via ActivityPub, forming a global network of over 1,600 platforms hosting more than one million videos. The REST API supports video uploading and management, channel and playlist operations, live streaming, search and discovery across federated nodes, content moderation, plugin management, and distributed transcoding via remote runner jobs.

## Kin Score — 34.5 / 100 (thin)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 34.5).

| Facet | Score |
|---|---|
| Discoverability | 68.5 |
| Contract Quality | 57.2 |
| Governance | 9.8 |
| Contract Governance | 9.8 |
| Operational Transparency | 5.3 |
| Developer Ergonomics | 28.6 |
| Commercial Clarity | 28.9 |
| Access Clarity | 28.9 |

## Agent readiness — 43.9 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | documented |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | partial |
| Rate Limit Signal | verified |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Free · Self-serve signup — onboarding: self-serve, pricing: free, trial: no (confidence: high).

## APIs (54)

- **PeerTube Abuses API** — Abuses deal with reports of local or remote videos/comments/accounts alike.
- **PeerTube Account Blocklist API** — The Account Blocklist API from PeerTube — 5 operation(s) for account blocklist.
- **PeerTube Accounts API** — Accounts encompass remote accounts discovered across the federation, and correspond to the main Actor, along with video channels a user can create, which are also Actors. When a...
- **PeerTube Automatic Tags API** — Automatic tags set on objects (like comments or videos) by specific rules (external link, watched words, etc.)
- **PeerTube Channels Sync API** — Operations dealing with synchronizing PeerTube user's channel with channels of other platforms
- **PeerTube Client Config API** — Configuration of the web client.
- **PeerTube Config API** — Each server exposes public information regarding supported videos and options.
- **PeerTube Contact API** — Send a message to the instance administrators.
- **PeerTube Debug API** — Administrative debug endpoints.
- **PeerTube Homepage API** — Get and update the custom homepage
- **PeerTube Instance Follows API** — Managing servers which the instance interacts with is crucial to the concept of federation in PeerTube and external video indexation. The PeerTube server then deals with inter-s...
- **PeerTube Instance Redundancy API** — Redundancy is part of the inter-server solidarity that PeerTube fosters. Manage the list of instances you wish to help by seeding their videos according to the policy of video s...
- **PeerTube Job API** — Jobs are long-running tasks enqueued and processed by the instance itself. No additional worker registration is currently available.
- **PeerTube Live Videos API** — The Live Videos API from PeerTube — 4 operation(s) for live videos.
- **PeerTube Logs API** — Operations dealing with client, server and audit logs.
- **PeerTube My History API** — Operations related to your watch history.
- **PeerTube My Notifications API** — Notifications following new videos, follows or reports. They allow you to keep track of the interactions and overall important information that concerns you. You MAY set per-not...
- **PeerTube My Subscriptions API** — Operations related to your subscriptions to video channels, their new videos, and how to keep up to date with their latest publications!
- **PeerTube My User API** — Operations related to your own User, when logged-in.
- **PeerTube Ownership Change API** — The Ownership Change API from PeerTube — 12 operation(s) for ownership change.
- **PeerTube Player Settings API** — Operations dealing with video player settings for videos and channels.
- **PeerTube Plugins API** — Managing plugins installed from a local path or from NPM, or search for new ones.
- **PeerTube Register API** — As a visitor, you can use this API to open an account (if registrations are open on that PeerTube instance). As an admin, you should use the dedicated [User creation API](#opera...
- **PeerTube Runner Jobs API** — Manage runner jobs and runner-side job execution.
- **PeerTube Runner Registration Token API** — Manage runner registration tokens.
- **PeerTube Runners API** — Register, list and remove remote runners.
- **PeerTube Search API** — The search helps to find _videos_ or _channels_ from within the instance and beyond. Videos from other instances federated by the instance (that is, instances followed by the in...
- **PeerTube Server Blocklist API** — The Server Blocklist API from PeerTube — 5 operation(s) for server blocklist.
- **PeerTube Session API** — Sessions deal with access tokens over time. Only __one session token can currently be used at a time__.
- **PeerTube Static Video Files API** — The Static Video Files API from PeerTube — 4 operation(s) for static video files.
- **PeerTube Stats API** — Statistics
- **PeerTube User Exports API** — To create an archive of user data.
- **PeerTube User Imports API** — To import an archive of user data.
- **PeerTube Users API** — Using some features of PeerTube require authentication, for which User provide different levels of permission as well as associated user information. Each user has a correspondi...
- **PeerTube Video API** — Operations dealing with listing, uploading, fetching or modifying videos.
- **PeerTube Video Blocks API** — Operations dealing with blocking videos (removing them from view and preventing interactions).
- **PeerTube Video Captions API** — Operations dealing with listing, adding and removing closed captions of a video.
- **PeerTube Video Channels API** — Operations dealing with the creation, modification and listing of videos within a channel.
- **PeerTube Video Chapters API** — Operations dealing with managing chapters of a video.
- **PeerTube Video Comments API** — Operations dealing with comments to a video. Comments are organized in threads: adding a comment in response to the video starts a thread, adding a reply to a comment adds it to...
- …and 14 more, listed in full on the page.

## Agentic access (1)

- **Peertube Agentic Access** — 580 operations · 350 acting · 8 human-in-the-loop

## Security (2)

- **Peertube Authentication** — oauth2 · 1 scheme
- **Peertube Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC

## Plans (1)

- **Plans**

## Tags

Video, Decentralized, Federation, Open-Source, ActivityPub, Self-Hosted, Streaming

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/peertube/). Scores are computed from the provider's own public artifacts under a published rubric.
