PeerTube Project Homepage
API docs by Redocly

PeerTube (8.0.0)

Download OpenAPI specification:

URL: https://joinpeertube.org License: AGPLv3.0

The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite HTTP/REST library for your programming language to use PeerTube.

See the REST API quick start for a few examples of using the PeerTube API.

https://docs.joinpeertube.org/api-rest-reference.html

Authentication

When you sign up for an account on a PeerTube instance, you are given the possibility to generate sessions on it, and authenticate there using an access token. Only one access token can currently be used at a time.

Roles

Accounts are given permissions based on their role. There are three roles on PeerTube: Administrator, Moderator, and User. See the roles guide for a detail of their permissions.

Errors

The API uses standard HTTP status codes to indicate the success or failure of the API call, completed by a RFC7807-compliant response body.

HTTP 1.1 404 Not Found
Content-Type: application/problem+json; charset=utf-8

{
  "detail": "Video not found",
  "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

We provide error type (following RFC7807) and code (internal PeerTube code) values for a growing number of cases, but it is still optional. Types are used to disambiguate errors that bear the same status code and are non-obvious:

HTTP 1.1 403 Forbidden
Content-Type: application/problem+json; charset=utf-8

{
  "detail": "Cannot get this video regarding follow constraints",
  "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
  "status": 403,
  "title": "Forbidden",
  "type": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints"
}

Here a 403 error could otherwise mean that the video is private or blocklisted.

Validation errors

Each parameter is evaluated on its own against a set of rules before the route validator proceeds with potential testing involving parameter combinations. Errors coming from validation errors appear earlier and benefit from a more detailed error description:

HTTP 1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "detail": "Incorrect request parameters: id",
  "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
  "instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180",
  "invalid-params": {
    "id": {
      "location": "params",
      "msg": "Invalid value",
      "param": "id",
      "value": "9c9de5e8-0a1e-484a-b099-e80766180"
    }
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Where id is the name of the field concerned by the error, within the route definition. invalid-params.<field>.location can be either 'params', 'body', 'header', 'query' or 'cookies', and invalid-params.<field>.value reports the value that didn't pass validation whose invalid-params.<field>.msg is about.

Deprecated error fields

Some fields could be included with previous versions. They are still included but their use is deprecated:

  • error: superseded by detail

Rate limits

We are rate-limiting all endpoints of PeerTube's API. Custom values can be set by administrators:

Endpoint (prefix: /api/v1) Calls Time frame
/* 50 10 seconds
POST /users/token 15 5 minutes
POST /users/register 2* 5 minutes
POST /users/ask-send-verify-email 3 5 minutes

Depending on the endpoint, *failed requests are not taken into account. A service limit is announced by a 429 Too Many Requests status code.

You can get details about the current state of your rate limit by reading the following headers:

Header Description
X-RateLimit-Limit Number of max requests allowed in the current time period
X-RateLimit-Remaining Number of remaining requests in the current time period
X-RateLimit-Reset Timestamp of end of current time period as UNIX timestamp
Retry-After Seconds to delay after the first 429 is received

CORS

This API features Cross-Origin Resource Sharing (CORS), allowing cross-domain communication from the browser for some routes:

| Endpoint | |------------------------- ---| | /api/* | | /download/* | | /lazy-static/* | | /.well-known/webfinger |

In addition, all routes serving ActivityPub are CORS-enabled for all origins.

Static Video Files

Get public Web Video file

PeerTube >= 6.0

path Parameters
filename
required
string

Filename

Responses

Get private Web Video file

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
filename
required
string

Filename

query Parameters
videoFileToken
string

Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header.

Responses

Get public HLS video file

Authorizations:
OAuth2
path Parameters
filename
required
string

Filename

Responses

Get private HLS video file

Authorizations:
OAuth2
path Parameters
filename
required
string

Filename

query Parameters
reinjectVideoFileToken
boolean

Ask the server to reinject videoFileToken in URLs in m3u8 playlist

videoFileToken
string

Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header.

Responses

Video Download

Download video files

Download video file

Generate a mp4 container that contains at most 1 video stream and at most 1 audio stream. Mainly used to merge the HLS audio only video file and the HLS video only resolution file.

path Parameters
videoId
required
integer >= 1
Example: 42

The video id

query Parameters
videoFileIds
required
Array of integers

streams of video files to mux in the output

videoFileToken
string

Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header.

Responses

Video Feeds

Server syndication feeds of videos

Comments on videos feeds

path Parameters
format
required
string
Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1"

format expected (we focus on making rss the most feature-rich ; it serves Media RSS)

query Parameters
accountId
string

limit listing comments to videos of a specific account

accountName
string

limit listing comments to videos of a specific account

videoChannelId
string

limit listing comments to videos of a specific video channel

videoChannelName
string

limit listing comments to videos of a specific video channel

videoId
string

limit listing comments to a specific video

Responses

Response samples

Content type
<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>PeerTube Nightly</title>
        <link>https://peertube2.cpy.re</link>
        <description>This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.</description>
        <lastBuildDate>Mon, 19 Jan 2026 04:03:41 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>PeerTube - https://peertube2.cpy.re</generator>
        <image>
            <title>PeerTube Nightly</title>
            <url>https://peertube2.cpy.re/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png</url>
            <link>https://peertube2.cpy.re</link>
        </image>
        <copyright>All rights reserved, unless otherwise specified in the terms specified at https://peertube2.cpy.re/about and potential licenses granted by each content's rightholder.</copyright>
        <atom:link href="https://peertube2.cpy.re/feeds/video-comments.xml?scope=local" rel="self" type="application/rss+xml"/>
        <item>
            <title><![CDATA[Budgie & GNOME drop X11, Wikipedia signs deal with AI companies - Linux weekly News - Urvogelisk]]></title>
            <link>https://peertube2.cpy.re/w/fAiuN5nAwMDMPUvEAeiiH9;threadId=182832</link>
            <guid>https://peertube2.cpy.re/w/fAiuN5nAwMDMPUvEAeiiH9;threadId=182832</guid>
            <pubDate>Mon, 19 Jan 2026 02:12:11 GMT</pubDate>
            <content:encoded><![CDATA[<p>Oh man seeing Wikipedia sign a deal with the big tech slop merchants is terrible news. We might legit might be truly fucked if AI turns out to not be a bubble, unless we somehow cobble together a solution that allows knowledge to spread without AI poisoning it.</p>
]]></content:encoded>
            <dc:creator>Urvogelisk</dc:creator>
        </item>
        <item>
            <title><![CDATA[Is Linux at 11%? Valve's Android translation layer - Linux Weekly News - Tyxxum]]></title>
            <link>https://peertube2.cpy.re/w/s64J3Be1kJNknrCwyVX9qx;threadId=182829</link>
            <guid>https://peertube2.cpy.re/w/s64J3Be1kJNknrCwyVX9qx;threadId=182829</guid>
            <pubDate>Sun, 18 Jan 2026 20:33:41 GMT</pubDate>
            <content:encoded><![CDATA[<p>@videos@video.neliger.com They certainly wouldn't count Linux users on Manjaro or Fedora as ChromeOS or Android users. It's a fun "square is a rectangle, rectangle is not a square" situation.</p>
]]></content:encoded>
            <dc:creator>Tyxxum</dc:creator>
        </item>
        <item>
            <title><![CDATA[JEANNE D'ARC LA GAUCHISTE : ÉLOGE DE LA RÉSISTANCE - Julianoë]]></title>
            <link>https://peertube2.cpy.re/w/3pThM9AR98QYHQfuDVxrkh;threadId=182828</link>
            <guid>https://peertube2.cpy.re/w/3pThM9AR98QYHQfuDVxrkh;threadId=182828</guid>
            <pubDate>Sun, 18 Jan 2026 14:39:37 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> dommage que la chaîne Peertube de Blast ne tire pas parti de la fonctionnalité des playlistes de vidéos. Ça permettrait de plus facilement regarder cette excellente série <a href="https://docs.joinpeertube.org/fr/use/video-playlist" target="_blank" rel="noopener noreferrer"><span>https://</span><span>docs.joinpeertube.org/fr/use/v</span><span>ideo-playlist</span></a></p>]]></content:encoded>
            <dc:creator>Julianoë</dc:creator>
        </item>
        <item>
            <title><![CDATA[Linux Mint 22.3: making the terminal even more optional! - Mike Mueller]]></title>
            <link>https://peertube2.cpy.re/w/a1CGAwt3fush7XGwHDvabC;threadId=182825</link>
            <guid>https://peertube2.cpy.re/w/a1CGAwt3fush7XGwHDvabC;threadId=182825</guid>
            <pubDate>Sat, 17 Jan 2026 06:27:55 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://lemmy.world/u/DarrinBrunner" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>DarrinBrunner</span></a></span> <span><a href="https://tilvids.com/accounts/thelinuxexperiment" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>thelinuxexperiment</span></a></span> 
New to the Fediverse so take it easy on me,  What do you mean by bot ads?</p>]]></content:encoded>
            <dc:creator>Mike Mueller</dc:creator>
        </item>
        <item>
            <title><![CDATA[Garder sa vieille voiture thermique : plus écolo… vraiment ? - Geneviève ⏚]]></title>
            <link>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182800</link>
            <guid>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182800</guid>
            <pubDate>Fri, 16 Jan 2026 19:02:42 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://tooting.ch/@lahminewski" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>lahminewski</span></a></span> <span><a href="https://skeptikon.fr/a/rodolphe_meyer/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>rodolphe_meyer</span></a></span> ça signifie probablement pas que la voiture thermique soit "mieux". M'enfin à minima qu'on a besoin d'urgence de faire dégonfler la taille des véhicules en même temps que l'électrification.
Ce qui sous entend des solutions collectives pour le transport longue distance.
Ce qui sous entend aussi une offre adaptée, ce qui n'est clairement pas le cas au vu du marché.</p>]]></content:encoded>
            <dc:creator>Geneviève ⏚</dc:creator>
        </item>
        <item>
            <title><![CDATA[Sommes-nous à l’aube d’une nouvelle dissolution ? - gkrnours]]></title>
            <link>https://peertube2.cpy.re/w/enEyneaFHRviXkse8KLgxB;threadId=182821</link>
            <guid>https://peertube2.cpy.re/w/enEyneaFHRviXkse8KLgxB;threadId=182821</guid>
            <pubDate>Fri, 16 Jan 2026 18:06:45 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> je me demande si en cas de dissolution aujourd'hui, marine peut se presenter</p>]]></content:encoded>
            <dc:creator>gkrnours</dc:creator>
        </item>
        <item>
            <title><![CDATA[Garder sa vieille voiture thermique : plus écolo… vraiment ? - Lahminewski ⚒️]]></title>
            <link>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182800</link>
            <guid>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182800</guid>
            <pubDate>Fri, 16 Jan 2026 16:53:11 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://toot.aquilenet.fr/@vieveca" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>vieveca</span></a></span> <span><a href="https://skeptikon.fr/a/rodolphe_meyer/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>rodolphe_meyer</span></a></span> </p><p>Bonne question.
D'autant que la raréfaction des ressources en métaux risque d'augmenter fortement le bilan carbone, dans les années avenir, sans hypothétique progrès dans l'extraction et le recyclage, non ?  </p><p>J'aimerais également souligner que l'élimination (le recyclage ?) est peut-être aussi un point important à prendre en compte dans ces bilans. Ça devrait au moins poussé ces courbes vers le haut.</p>]]></content:encoded>
            <dc:creator>Lahminewski ⚒️</dc:creator>
        </item>
        <item>
            <title><![CDATA[(Ne) détruisons (pas) le capitalisme avec une coopérative - Agnès Haasser et Arthur Vuillard - JdLL2025 - Jaxom Kaplan]]></title>
            <link>https://peertube2.cpy.re/w/iqo9UL33xeXKk9VhwnjsQz;threadId=182820</link>
            <guid>https://peertube2.cpy.re/w/iqo9UL33xeXKk9VhwnjsQz;threadId=182820</guid>
            <pubDate>Fri, 16 Jan 2026 16:42:54 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://videos-libr.es/a/orga_jdll/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>orga_jdll</span></a></span> Merci pour cette chouette présentation (de l'intérieur) des possibles en <a href="https://mamot.fr/tags/coop%C3%A9rative" class="mention hashtag" rel="noopener noreferrer" target="_blank">#<span>coopérative</span></a> 😉 
A poursuivre avec <span><a href="https://framapiaf.org/@AstrolabeCAE" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>AstrolabeCAE</span></a></span> et <span><a href="https://mastodon.scop.coop/@LesScopAura" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>LesScopAura</span></a></span> 😄</p>]]></content:encoded>
            <dc:creator>Jaxom Kaplan</dc:creator>
        </item>
        <item>
            <title><![CDATA[C'est trolldi, c'est permis, ép. 100 : Peut-on sauver la F-Void ? - impromptux]]></title>
            <link>https://peertube2.cpy.re/w/8EaVG4Shgytbqcz457ZKyf;threadId=182819</link>
            <guid>https://peertube2.cpy.re/w/8EaVG4Shgytbqcz457ZKyf;threadId=182819</guid>
            <pubDate>Fri, 16 Jan 2026 16:09:39 GMT</pubDate>
            <content:encoded><![CDATA[<p>Je ne pense pas que le bug que tu as rencontré soit lié à V-Droid mais plus à LXDE. J’ai rencontré le même problème sur une Debian lors du passage de la 12 à la 13.</p>
]]></content:encoded>
            <dc:creator>impromptux</dc:creator>
        </item>
        <item>
            <title><![CDATA[Peux-on encore faire confiance aux assistants vocaux - Lutin Discret]]></title>
            <link>https://peertube2.cpy.re/w/bYxcBzxByV1ihhwNiA4k2i;threadId=182818</link>
            <guid>https://peertube2.cpy.re/w/bYxcBzxByV1ihhwNiA4k2i;threadId=182818</guid>
            <pubDate>Fri, 16 Jan 2026 15:54:39 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://videos-libr.es/a/orga_jdll/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>orga_jdll</span></a></span> ça peut intéresser <span><a href="https://mastodon.social/@gael" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>gael</span></a></span> qui cherche (encore ?) une solution voix vers texte open-source et instantannée</p>]]></content:encoded>
            <dc:creator>Lutin Discret</dc:creator>
        </item>
        <item>
            <title><![CDATA[What is PeerTube? (english subtitles) - ivek2026]]></title>
            <link>https://peertube2.cpy.re/w/58UdeJ7NayzNSScpTE3YRa;threadId=182817</link>
            <guid>https://peertube2.cpy.re/w/58UdeJ7NayzNSScpTE3YRa;threadId=182817</guid>
            <pubDate>Fri, 16 Jan 2026 15:54:15 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://framatube.org/a/framasoft/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>framasoft</span></a></span> Greetings from the Croatian mastodon instance!</p>]]></content:encoded>
            <dc:creator>ivek2026</dc:creator>
        </item>
        <item>
            <title><![CDATA[Spring - Blender Open Movie - ivek2026]]></title>
            <link>https://peertube2.cpy.re/w/8B5QmoLSS3mWJ4fmZZu3Ye;threadId=182816</link>
            <guid>https://peertube2.cpy.re/w/8B5QmoLSS3mWJ4fmZZu3Ye;threadId=182816</guid>
            <pubDate>Fri, 16 Jan 2026 15:36:11 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blender.org/accounts/blender" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blender</span></a></span> :):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):):)</p>]]></content:encoded>
            <dc:creator>ivek2026</dc:creator>
        </item>
        <item>
            <title><![CDATA[2026 : et surtout la santé ! - Obrow :verified: :bloblurk:]]></title>
            <link>https://peertube2.cpy.re/w/5LwozbT5yL4Vu3AFVoHout;threadId=182814</link>
            <guid>https://peertube2.cpy.re/w/5LwozbT5yL4Vu3AFVoHout;threadId=182814</guid>
            <pubDate>Thu, 15 Jan 2026 20:53:01 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> J'aime bien Sébastien Fontenelle, ses analyses sont toujours au top.</p>]]></content:encoded>
            <dc:creator>Obrow :verified: :bloblurk:</dc:creator>
        </item>
        <item>
            <title><![CDATA[Garder sa vieille voiture thermique : plus écolo… vraiment ? - Metrics]]></title>
            <link>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182803</link>
            <guid>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182803</guid>
            <pubDate>Wed, 14 Jan 2026 18:19:52 GMT</pubDate>
            <content:encoded><![CDATA[<p>@lasourisverte@mastodon.social Oui c'est bien dommage, j'ai entendu que sur certains autres points ça émet beaucoup</p>
<p>Ils ont une autre vidéo mais je suis pas sûr que ça en traite</p>
]]></content:encoded>
            <dc:creator>Metrics</dc:creator>
        </item>
        <item>
            <title><![CDATA[Garder sa vieille voiture thermique : plus écolo… vraiment ? - Metrics]]></title>
            <link>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182801</link>
            <guid>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182801</guid>
            <pubDate>Wed, 14 Jan 2026 14:24:35 GMT</pubDate>
            <content:encoded><![CDATA[<p>@romifla@skeptikon.fr formbricks est bien (open source, peut être selfhost, ou utilisé sur le site des créateurs)</p>
]]></content:encoded>
            <dc:creator>Metrics</dc:creator>
        </item>
        <item>
            <title><![CDATA[KDE drops X11 too, New Office Suite, Arduino turns to crap - Linux Weekly News - Darshak Parikh]]></title>
            <link>https://peertube2.cpy.re/w/rBJLfz558AGQNAcZYgHbip;threadId=182809</link>
            <guid>https://peertube2.cpy.re/w/rBJLfz558AGQNAcZYgHbip;threadId=182809</guid>
            <pubDate>Wed, 14 Jan 2026 11:12:26 GMT</pubDate>
            <content:encoded><![CDATA[<p>Thank you for pronouncing aluminium correctly. The Americans have ruined it otherwise.</p>
]]></content:encoded>
            <dc:creator>Darshak Parikh</dc:creator>
        </item>
        <item>
            <title><![CDATA[Après le désastre des Ehpad, le groupe Orpea rebondit en psychiatrie - CAULY]]></title>
            <link>https://peertube2.cpy.re/w/hGkPHJt8KQv6uc9kUCqzRL;threadId=182808</link>
            <guid>https://peertube2.cpy.re/w/hGkPHJt8KQv6uc9kUCqzRL;threadId=182808</guid>
            <pubDate>Wed, 14 Jan 2026 08:10:14 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> Catastrophe annoncée.</p>]]></content:encoded>
            <dc:creator>CAULY</dc:creator>
        </item>
        <item>
            <title><![CDATA[Garder sa vieille voiture thermique : plus écolo… vraiment ? - Tristor]]></title>
            <link>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182807</link>
            <guid>https://peertube2.cpy.re/w/oRRmmDXkfzLbE2tLhGn4ii;threadId=182807</guid>
            <pubDate>Wed, 14 Jan 2026 06:34:29 GMT</pubDate>
            <content:encoded><![CDATA[<p>Bjr, mon ancienne Mondéo de 2005 reprise (une bouchée de pain) impeccable continue de polluer dans les pays de l'Est ou en Afrique, tandis que ma Volvo de 2010 pollue encore plus car plus sophistiquée, reste plus écolo qu'une nouvelle voiture qui demanderait encore plus de maintenance etc.</p>
]]></content:encoded>
            <dc:creator>Tristor</dc:creator>
        </item>
        <item>
            <title><![CDATA[Nvidia finally focuses on Linux, EU caves to Big Tech - Linux Weekly News - Darshak Parikh]]></title>
            <link>https://peertube2.cpy.re/w/oxsJNbqYrrh8sAPxdKYaYo;threadId=182517</link>
            <guid>https://peertube2.cpy.re/w/oxsJNbqYrrh8sAPxdKYaYo;threadId=182517</guid>
            <pubDate>Wed, 14 Jan 2026 00:32:17 GMT</pubDate>
            <content:encoded><![CDATA[<p>It was in a month, not in a day. Still big though.</p>
]]></content:encoded>
            <dc:creator>Darshak Parikh</dc:creator>
        </item>
        <item>
            <title><![CDATA[Après le désastre des Ehpad, le groupe Orpea rebondit en psychiatrie - Emmanuel Florac]]></title>
            <link>https://peertube2.cpy.re/w/hGkPHJt8KQv6uc9kUCqzRL;threadId=182805</link>
            <guid>https://peertube2.cpy.re/w/hGkPHJt8KQv6uc9kUCqzRL;threadId=182805</guid>
            <pubDate>Tue, 13 Jan 2026 22:48:40 GMT</pubDate>
            <content:encoded><![CDATA[<p>Corruption partout. La seule solution, la révolution, on nationalise tout.</p>
]]></content:encoded>
            <dc:creator>Emmanuel Florac</dc:creator>
        </item>
    </channel>
</rss>

Common videos feeds

path Parameters
format
required
string
Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1"

format expected (we focus on making rss the most feature-rich ; it serves Media RSS)

query Parameters
accountId
string

limit listing to a specific account

accountName
string

limit listing to a specific account

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

sort
string
Example: sort=-createdAt

Sort column

videoChannelId
string

limit listing to a specific video channel

videoChannelName
string

limit listing to a specific video channel

Responses

Response samples

Content type
<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:podcast="https://podcastindex.org/namespace/1.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>PeerTube Nightly</title>
        <link>https://peertube2.cpy.re</link>
        <description>This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.</description>
        <lastBuildDate>Mon, 19 Jan 2026 04:03:41 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>PeerTube - https://peertube2.cpy.re</generator>
        <image>
            <title>PeerTube Nightly</title>
            <url>https://peertube2.cpy.re/lazy-static/avatars/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.png</url>
            <link>https://peertube2.cpy.re</link>
        </image>
        <copyright>All rights reserved, unless otherwise specified in the terms specified at https://peertube2.cpy.re/about and potential licenses granted by each content's rightholder.</copyright>
        <atom:link href="https://peertube2.cpy.re/feeds/videos.xml?scope=local" rel="self" type="application/rss+xml"/>
        <item>
            <title><![CDATA[Cockney Rejects - Bad Man - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/pmCx3X1pJJZKHM7qcHohDP</link>
            <guid>https://peertube2.cpy.re/w/pmCx3X1pJJZKHM7qcHohDP</guid>
            <pubDate>Sun, 18 Jan 2026 20:42:05 GMT</pubDate>
            <description><![CDATA[Cockney Rejects - Bad Man - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Cockney Rejects - Bad Man - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="80441627" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/bd23948e-3440-46fd-971c-2982b0eadfb1?videoFileIds=5536007"/>
            <media:community>
                <media:statistics views="4"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/pmCx3X1pJJZKHM7qcHohDP"/>
            <media:player url="https://peertube2.cpy.re/w/pmCx3X1pJJZKHM7qcHohDP"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/aea51206-666d-4f76-a3a8-9c301f44ecfb-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/de9645ab-faed-4560-aec2-c7c5377a46b2-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4478100c-6607-401b-b6a1-1a33ede6ba3b-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/91fbf232-0768-4914-84aa-014e225ed1b2-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9e21f576-e697-4552-8f81-0226ed9e493b-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="80441627" url="https://www.yiny.org/static/streaming-playlists/hls/bd23948e-3440-46fd-971c-2982b0eadfb1/6c781267-c2b5-46e0-a9f2-7dd35870199b-1080-fragmented.mp4" framerate="30" duration="171" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="41770744" url="https://www.yiny.org/static/streaming-playlists/hls/bd23948e-3440-46fd-971c-2982b0eadfb1/6e1aff33-8211-458e-853e-642be2c43c27-720-fragmented.mp4" framerate="30" duration="171" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="23427626" url="https://www.yiny.org/static/streaming-playlists/hls/bd23948e-3440-46fd-971c-2982b0eadfb1/c7883ea2-c72b-4fa9-8719-d11b0d53f68c-480-fragmented.mp4" framerate="30" duration="171" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="10092948" url="https://www.yiny.org/static/streaming-playlists/hls/bd23948e-3440-46fd-971c-2982b0eadfb1/c6e55480-e8d8-4b84-aff1-27e6b3683809-240-fragmented.mp4" framerate="30" duration="171" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2795971" url="https://www.yiny.org/static/streaming-playlists/hls/bd23948e-3440-46fd-971c-2982b0eadfb1/94e6f441-bd7a-419c-bc0a-b4f41a71f982-0-fragmented.mp4" framerate="0" duration="171" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/e153de10-9241-4672-af31-5348168594cd.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/8b4311c6-b76f-4c78-8dca-449902537fbc.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Cockney Rejects - Bad Man - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Cockney Rejects - Bad Man - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Cockney Rejects - The Greatest Cockney Rip Off - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/o1DyyusxN2TB2t2nY78zWd</link>
            <guid>https://peertube2.cpy.re/w/o1DyyusxN2TB2t2nY78zWd</guid>
            <pubDate>Sun, 18 Jan 2026 20:38:33 GMT</pubDate>
            <description><![CDATA[Cockney Rejects - The Greatest Cockney Rip Off - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Cockney Rejects - The Greatest Cockney Rip Off - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="58397155" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/b24032d3-ca91-45a5-80c1-ac2ad1c49524?videoFileIds=5535997"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/o1DyyusxN2TB2t2nY78zWd"/>
            <media:player url="https://peertube2.cpy.re/w/o1DyyusxN2TB2t2nY78zWd"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a3e53fc0-1724-4163-a742-6a5571317940-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/877ee2ce-694a-4294-b131-98af84a496ab-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/adc925f4-9469-479a-8a61-836dc160bba2-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/431d4e75-5f29-4c04-a211-5720761e5251-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f113cefa-a130-40b2-a543-bec10b8ca9b1-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="58397155" url="https://www.yiny.org/static/streaming-playlists/hls/b24032d3-ca91-45a5-80c1-ac2ad1c49524/78ab434a-1536-4fb6-8e3f-4b683f5c1a7d-1080-fragmented.mp4" framerate="30" duration="145" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="30103618" url="https://www.yiny.org/static/streaming-playlists/hls/b24032d3-ca91-45a5-80c1-ac2ad1c49524/9b17d32c-3bdc-46e6-b9a7-a5a39eb4b506-720-fragmented.mp4" framerate="30" duration="145" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="17011078" url="https://www.yiny.org/static/streaming-playlists/hls/b24032d3-ca91-45a5-80c1-ac2ad1c49524/25f58e74-ae22-442b-b1fe-83afdaa134f5-480-fragmented.mp4" framerate="30" duration="145" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="7591873" url="https://www.yiny.org/static/streaming-playlists/hls/b24032d3-ca91-45a5-80c1-ac2ad1c49524/69ccfca5-37aa-4e41-a04e-5f2edf240fbe-240-fragmented.mp4" framerate="30" duration="145" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2373743" url="https://www.yiny.org/static/streaming-playlists/hls/b24032d3-ca91-45a5-80c1-ac2ad1c49524/d614a7b1-0aaa-4b1e-a004-7469a2fe3a78-0-fragmented.mp4" framerate="0" duration="145" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/91b74357-6370-43f4-a689-f1be80aa897e.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/2cdf721e-b18b-4d6e-8650-12f387e0bf25.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Cockney Rejects - The Greatest Cockney Rip Off - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Cockney Rejects - The Greatest Cockney Rip Off - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Cockney Rejects - Headbanger + Someone Like You - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/4doXnwkykd1dtmU6gnJWYQ</link>
            <guid>https://peertube2.cpy.re/w/4doXnwkykd1dtmU6gnJWYQ</guid>
            <pubDate>Sun, 18 Jan 2026 20:38:28 GMT</pubDate>
            <description><![CDATA[Cockney Rejects - Headbanger + Someone Like You - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Cockney Rejects - Headbanger + Someone Like You - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="108787209" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/1a067ccf-7282-44f3-b7d1-54a40d5fd6f8?videoFileIds=5535988"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/4doXnwkykd1dtmU6gnJWYQ"/>
            <media:player url="https://peertube2.cpy.re/w/4doXnwkykd1dtmU6gnJWYQ"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/dc83edab-4db3-4cca-a765-b87dee6be892-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/29d376a6-3b30-4dd1-90b8-ef33c86630eb-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6c67ba77-e2ba-4ad9-95a9-86621fb01588-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e47a92ce-85a0-4039-954b-79fa636a9d59-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ce3cc462-908e-4dc1-9304-8832bcfba97f-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/640577fc-d29c-43e5-b574-1fa2a8e19b4f-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="108787209" url="https://www.yiny.org/static/web-videos/812e3e2c-9884-455b-804c-8ef4d381bcc2-1080.mp4" framerate="30" duration="289" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="105265848" url="https://www.yiny.org/static/streaming-playlists/hls/1a067ccf-7282-44f3-b7d1-54a40d5fd6f8/903ff362-f92b-4727-971b-b5a7bd456582-1080-fragmented.mp4" framerate="30" duration="289" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="56110181" url="https://www.yiny.org/static/streaming-playlists/hls/1a067ccf-7282-44f3-b7d1-54a40d5fd6f8/fd99796b-44c4-48f0-b567-89d7f449732a-720-fragmented.mp4" framerate="30" duration="289" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="33000184" url="https://www.yiny.org/static/streaming-playlists/hls/1a067ccf-7282-44f3-b7d1-54a40d5fd6f8/b69c33e9-bdca-4683-b4c4-5439dd4d15e3-480-fragmented.mp4" framerate="30" duration="289" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="14935027" url="https://www.yiny.org/static/streaming-playlists/hls/1a067ccf-7282-44f3-b7d1-54a40d5fd6f8/2cb73145-3bc1-448a-b400-da3a4dba0789-240-fragmented.mp4" framerate="30" duration="289" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="4746275" url="https://www.yiny.org/static/streaming-playlists/hls/1a067ccf-7282-44f3-b7d1-54a40d5fd6f8/32924b0c-8ab1-41db-b8e2-debfc001c231-0-fragmented.mp4" framerate="0" duration="289" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/6d844250-f694-441b-8960-fccb312614e0.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/72268221-c172-454d-9fd5-ab67f7ab772d.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Cockney Rejects - Headbanger + Someone Like You - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Cockney Rejects - Headbanger + Someone Like You - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Cockney Rejects - We Are the Firm - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/pvhFSUyUQNsbnzisQNUCkY</link>
            <guid>https://peertube2.cpy.re/w/pvhFSUyUQNsbnzisQNUCkY</guid>
            <pubDate>Sun, 18 Jan 2026 20:37:01 GMT</pubDate>
            <description><![CDATA[Cockney Rejects - We Are the Firm - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Cockney Rejects - We Are the Firm - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="105003571" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/be590ae6-3d0c-42b9-9c94-a869a7cc2496?videoFileIds=5535984"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/pvhFSUyUQNsbnzisQNUCkY"/>
            <media:player url="https://peertube2.cpy.re/w/pvhFSUyUQNsbnzisQNUCkY"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3f27a1b2-1229-4a83-8932-6bf58b4a02cd-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1da46e23-2629-4e2c-990a-6762100c53ba-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c69675bb-9695-4cc2-a4ce-17c506a60dfd-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/93467848-9e10-47b6-8184-7cb677a1f385-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f74f2ea5-f837-4bfa-8756-247503842ea8-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/570e1dd8-9626-4b29-b62e-98db3dc2edb3-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="105003571" url="https://www.yiny.org/static/web-videos/862b05d9-5e59-4b0b-979b-49117b1cee13-1080.mp4" framerate="30" duration="219" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="98997319" url="https://www.yiny.org/static/streaming-playlists/hls/be590ae6-3d0c-42b9-9c94-a869a7cc2496/849c52f4-81d3-4e47-8314-4476fcb96c32-1080-fragmented.mp4" framerate="30" duration="219" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="53345217" url="https://www.yiny.org/static/streaming-playlists/hls/be590ae6-3d0c-42b9-9c94-a869a7cc2496/40a01e56-f34c-42eb-bb83-5c83add619ae-720-fragmented.mp4" framerate="30" duration="219" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="31160225" url="https://www.yiny.org/static/streaming-playlists/hls/be590ae6-3d0c-42b9-9c94-a869a7cc2496/ee013686-7b89-4c09-b9a3-b2072a995dd4-480-fragmented.mp4" framerate="30" duration="219" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="13517717" url="https://www.yiny.org/static/streaming-playlists/hls/be590ae6-3d0c-42b9-9c94-a869a7cc2496/4325c9cd-47f5-4a44-808a-11aa17371974-240-fragmented.mp4" framerate="30" duration="219" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3584848" url="https://www.yiny.org/static/streaming-playlists/hls/be590ae6-3d0c-42b9-9c94-a869a7cc2496/35a7d27e-efa6-47e4-b3ab-aab7b18f55a4-0-fragmented.mp4" framerate="0" duration="219" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/422e7eef-6d38-4c2b-a7fa-6a2eaebadf55.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/fe436654-9352-4629-9ee9-159bd695d1a3.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Cockney Rejects - We Are the Firm - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Cockney Rejects - We Are the Firm - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Cockney Rejects - Flares 'n' Slippers + Fighting in the Streets - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/fEros1fcDbJZq8pbSFPNos</link>
            <guid>https://peertube2.cpy.re/w/fEros1fcDbJZq8pbSFPNos</guid>
            <pubDate>Sun, 18 Jan 2026 20:31:55 GMT</pubDate>
            <description><![CDATA[Cockney Rejects - Flares 'n' Slippers + Fighting in the Streets - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Cockney Rejects - Flares 'n' Slippers + Fighting in the Streets - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="139609953" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/76bdd98d-c438-4eb1-bba5-02aca8da6096?videoFileIds=5535978"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/fEros1fcDbJZq8pbSFPNos"/>
            <media:player url="https://peertube2.cpy.re/w/fEros1fcDbJZq8pbSFPNos"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a079e768-8710-4104-84d4-ff20fb9d5161-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ecf10321-763b-464f-9ad2-8aeecb84aa63-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/632aea3c-aff4-401a-b9ad-3d2fab0e003d-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9192cd25-cc8e-45e0-b02e-71f9a67c4752-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6ed3f28d-d05d-4690-bbd5-ae2fde5c1fbf-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3bbc1255-814d-4f57-9912-648a4b1c07d5-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="139609953" url="https://www.yiny.org/static/web-videos/5e169f37-43d9-4ae4-9012-74eee7a7d042-1080.mp4" framerate="30" duration="228" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="135747393" url="https://www.yiny.org/static/streaming-playlists/hls/76bdd98d-c438-4eb1-bba5-02aca8da6096/9ab9b6fc-8d3e-4397-a10d-51058e71ba5d-1080-fragmented.mp4" framerate="30" duration="228" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="70057181" url="https://www.yiny.org/static/streaming-playlists/hls/76bdd98d-c438-4eb1-bba5-02aca8da6096/047630bb-f149-42aa-89fb-3729bca19272-720-fragmented.mp4" framerate="30" duration="228" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="38064604" url="https://www.yiny.org/static/streaming-playlists/hls/76bdd98d-c438-4eb1-bba5-02aca8da6096/ba443dfe-6ad2-44df-8d9f-a505c0cf919f-480-fragmented.mp4" framerate="30" duration="228" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="15443275" url="https://www.yiny.org/static/streaming-playlists/hls/76bdd98d-c438-4eb1-bba5-02aca8da6096/f01fae19-52f2-430c-8e99-1d86b1db0cfa-240-fragmented.mp4" framerate="30" duration="228" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3712395" url="https://www.yiny.org/static/streaming-playlists/hls/76bdd98d-c438-4eb1-bba5-02aca8da6096/1d56885b-a813-4dfb-9752-8630edf81b11-0-fragmented.mp4" framerate="0" duration="228" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/2ff55076-792f-42e7-aca1-fc1b19340450.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/513b02b7-780c-4a8d-b72c-61427170859a.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Cockney Rejects - Flares 'n' Slippers + Fighting in the Streets - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Cockney Rejects - Flares 'n' Slippers + Fighting in the Streets - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Cockney Rejects - East End - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/sAJot2GqsyMZtUMseHxW7Z</link>
            <guid>https://peertube2.cpy.re/w/sAJot2GqsyMZtUMseHxW7Z</guid>
            <pubDate>Sun, 18 Jan 2026 20:30:13 GMT</pubDate>
            <description><![CDATA[Cockney Rejects - East End - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Cockney Rejects - East End - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="69420915" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/d76703f5-cc4b-4fcf-a096-1a8c1306bbb5?videoFileIds=5535971"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/sAJot2GqsyMZtUMseHxW7Z"/>
            <media:player url="https://peertube2.cpy.re/w/sAJot2GqsyMZtUMseHxW7Z"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/172032e9-70f3-44a2-9204-b1e16b432ab4-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2b384240-b975-41cb-8962-b4f0bbc50251-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/20fc22a6-dcb4-4ca2-a653-e15f021bee78-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d3f9408b-1ad9-4ce9-8783-d2b29530fc26-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/99feb81a-6747-4f8b-93bb-f95daadd0fdc-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/391ecd90-1442-4bd7-b47c-a8ddbc3bcf56-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="69420915" url="https://www.yiny.org/static/web-videos/ef784357-b066-4ad8-86b0-128bc89b6273-1080.mp4" framerate="30" duration="146" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="66251277" url="https://www.yiny.org/static/streaming-playlists/hls/d76703f5-cc4b-4fcf-a096-1a8c1306bbb5/1d8f27ec-2de4-46ce-8599-3907a5e94dc2-1080-fragmented.mp4" framerate="30" duration="146" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="35909704" url="https://www.yiny.org/static/streaming-playlists/hls/d76703f5-cc4b-4fcf-a096-1a8c1306bbb5/5ba70ce9-e0e4-44f6-872f-e15e358bd71d-720-fragmented.mp4" framerate="30" duration="146" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="20946968" url="https://www.yiny.org/static/streaming-playlists/hls/d76703f5-cc4b-4fcf-a096-1a8c1306bbb5/97060abf-4c1a-4b68-9bf3-925a2b29921e-480-fragmented.mp4" framerate="30" duration="146" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="9127104" url="https://www.yiny.org/static/streaming-playlists/hls/d76703f5-cc4b-4fcf-a096-1a8c1306bbb5/47327a2f-82e0-49b0-ab27-2f34a3af4676-240-fragmented.mp4" framerate="30" duration="146" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2378160" url="https://www.yiny.org/static/streaming-playlists/hls/d76703f5-cc4b-4fcf-a096-1a8c1306bbb5/11c0f3b4-5bc0-4247-a1b2-d08478af8f2a-0-fragmented.mp4" framerate="0" duration="146" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/62ce4cdd-8c9b-429c-b5e5-abf11331b39e.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/0d26ac6c-4f76-4804-897f-6ab8de9cac6d.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Cockney Rejects - East End - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Cockney Rejects - East End - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[SurVet skinS - C'est mon sang - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/83xnHkxpgAhAmCCSbDtGw2</link>
            <guid>https://peertube2.cpy.re/w/83xnHkxpgAhAmCCSbDtGw2</guid>
            <pubDate>Sun, 18 Jan 2026 20:28:16 GMT</pubDate>
            <description><![CDATA[SurVet skinS - C'est mon sang - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>SurVet skinS - C'est mon sang - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="111028149" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/390acb15-57ad-494d-af60-ee9c518038b5?videoFileIds=5535973"/>
            <media:community>
                <media:statistics views="1"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/83xnHkxpgAhAmCCSbDtGw2"/>
            <media:player url="https://peertube2.cpy.re/w/83xnHkxpgAhAmCCSbDtGw2"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1512d366-9b56-4865-ba57-113855eeb94b-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6feee055-ff15-4c63-8933-21f4267a5f4f-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/90fb6724-c7d8-4b17-8378-ae5b93431c9f-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c210286b-a1f5-4176-ad0a-53476ea242c4-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8c8a2857-830b-4225-b198-1d92e8232753-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="111028149" url="https://www.yiny.org/static/streaming-playlists/hls/390acb15-57ad-494d-af60-ee9c518038b5/2f53fa28-6d67-4b57-9d58-b31c5f976c0e-1080-fragmented.mp4" framerate="29" duration="152" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="55796423" url="https://www.yiny.org/static/streaming-playlists/hls/390acb15-57ad-494d-af60-ee9c518038b5/b06bc40b-851e-43cd-b917-3092fe192f9f-720-fragmented.mp4" framerate="29" duration="152" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="28550086" url="https://www.yiny.org/static/streaming-playlists/hls/390acb15-57ad-494d-af60-ee9c518038b5/76b4555a-bc9d-45d8-9247-2badba8eb417-480-fragmented.mp4" framerate="29" duration="152" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="11738432" url="https://www.yiny.org/static/streaming-playlists/hls/390acb15-57ad-494d-af60-ee9c518038b5/b6c1087c-283e-4095-b884-69970d126061-240-fragmented.mp4" framerate="29" duration="152" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2476519" url="https://www.yiny.org/static/streaming-playlists/hls/390acb15-57ad-494d-af60-ee9c518038b5/0f93f00e-03f9-4049-abac-1c99f6655d9c-0-fragmented.mp4" framerate="0" duration="152" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/b1b05835-da16-4d86-809c-1e143dd9b281.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/47531028-1795-4d14-b75e-9f1bfb2320eb.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">SurVet skinS - C'est mon sang - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">SurVet skinS - C'est mon sang - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[SurVet skinS - Émeute - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/86koEXjBo72iiUjkh2ob5t</link>
            <guid>https://peertube2.cpy.re/w/86koEXjBo72iiUjkh2ob5t</guid>
            <pubDate>Sun, 18 Jan 2026 20:26:24 GMT</pubDate>
            <description><![CDATA[SurVet skinS - Émeute (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>SurVet skinS - Émeute (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="111708138" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/396ea3b8-4487-4651-b697-6f8b1c0998ab?videoFileIds=5535960"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/86koEXjBo72iiUjkh2ob5t"/>
            <media:player url="https://peertube2.cpy.re/w/86koEXjBo72iiUjkh2ob5t"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c3d4da24-a69b-464d-a67e-e1fc7a939af0-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/440effc1-0601-4135-af60-7009955cd4f5-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6594a1d5-b65a-4e88-9403-fec9be139d52-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/00c06956-c167-4c53-b505-b7c20fac83fc-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b581fd22-d67d-4bef-95f0-1cdbaab1a121-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/bde3d2f3-58ac-45e0-93ec-9f2026b284ea-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="111708138" url="https://www.yiny.org/static/web-videos/dc440b71-5a6f-44f0-81de-11025b61202e-1080.mp4" framerate="29" duration="146" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="107956133" url="https://www.yiny.org/static/streaming-playlists/hls/396ea3b8-4487-4651-b697-6f8b1c0998ab/19170831-92f6-4488-a514-faa4869ef9b9-1080-fragmented.mp4" framerate="29" duration="146" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="54951443" url="https://www.yiny.org/static/streaming-playlists/hls/396ea3b8-4487-4651-b697-6f8b1c0998ab/c1819bf3-7ba0-4ee1-a99e-7ad33025b695-720-fragmented.mp4" framerate="29" duration="146" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="28247850" url="https://www.yiny.org/static/streaming-playlists/hls/396ea3b8-4487-4651-b697-6f8b1c0998ab/e3af8352-0dcc-4e43-bff9-80b82677fb1a-480-fragmented.mp4" framerate="29" duration="146" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="11592608" url="https://www.yiny.org/static/streaming-playlists/hls/396ea3b8-4487-4651-b697-6f8b1c0998ab/0231a12c-4940-4e00-b286-6264ec0215ef-240-fragmented.mp4" framerate="29" duration="146" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2393540" url="https://www.yiny.org/static/streaming-playlists/hls/396ea3b8-4487-4651-b697-6f8b1c0998ab/73edb47d-9dcf-4799-9918-a853c90ba530-0-fragmented.mp4" framerate="0" duration="146" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/f45f7a70-968f-4bdd-a430-cc17b74d1136.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/4cf40981-83d1-47cf-ae9e-80debfddf451.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">SurVet skinS - Émeute - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">SurVet skinS - Émeute (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[SurVet skinS - Le Grec - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/sbBSzg1zpKQhsvfZKEXgne</link>
            <guid>https://peertube2.cpy.re/w/sbBSzg1zpKQhsvfZKEXgne</guid>
            <pubDate>Sun, 18 Jan 2026 20:20:57 GMT</pubDate>
            <description><![CDATA[SurVet skinS - Le Grec - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>SurVet skinS - Le Grec - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="117118752" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/d4092655-385c-44d6-b009-752fd7e2c303?videoFileIds=5535946"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/sbBSzg1zpKQhsvfZKEXgne"/>
            <media:player url="https://peertube2.cpy.re/w/sbBSzg1zpKQhsvfZKEXgne"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/da2ca6aa-3d2b-4f5c-9987-a32eca34f3f2-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/65aaf9c5-0a60-44fd-ab02-f52ad79287e3-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0cfa88f1-b95f-4831-af8a-8e1e7de3fec2-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/cc3a52ac-bb83-47e3-9fa2-d8c5dfc28ef7-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4efe406f-8a3e-4cf4-95ee-af0c4190fbbd-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c66ae76f-87ab-41b6-a894-14deee89376e-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="117118752" url="https://www.yiny.org/static/web-videos/7e535810-80db-44da-a6c3-01ec365f84a5-1080.mp4" framerate="30" duration="184" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="109606159" url="https://www.yiny.org/static/streaming-playlists/hls/d4092655-385c-44d6-b009-752fd7e2c303/357669ac-5786-4d67-aa4a-af719a19f8dc-1080-fragmented.mp4" framerate="30" duration="184" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="58312020" url="https://www.yiny.org/static/streaming-playlists/hls/d4092655-385c-44d6-b009-752fd7e2c303/6dc4d47f-721c-4d17-853e-fdd43bede124-720-fragmented.mp4" framerate="30" duration="184" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="32423786" url="https://www.yiny.org/static/streaming-playlists/hls/d4092655-385c-44d6-b009-752fd7e2c303/a6866402-70b1-4fb5-993f-b77b02d943e5-480-fragmented.mp4" framerate="30" duration="184" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="13486284" url="https://www.yiny.org/static/streaming-playlists/hls/d4092655-385c-44d6-b009-752fd7e2c303/0c9c5f54-6d84-4a2c-88d3-0197005222e7-240-fragmented.mp4" framerate="30" duration="184" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3024780" url="https://www.yiny.org/static/streaming-playlists/hls/d4092655-385c-44d6-b009-752fd7e2c303/3c263a40-c9aa-480a-aeff-bd9be65fe90f-0-fragmented.mp4" framerate="0" duration="184" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/213f7ed2-125d-4427-b9a1-716a38d033f8.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/dc77d422-fe72-4d8f-a342-639158f6cfec.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">SurVet skinS - Le Grec - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">SurVet skinS - Le Grec - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[SurVet skinS - Dédé - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/nGinNRZBRXEuiwZMsqARLH</link>
            <guid>https://peertube2.cpy.re/w/nGinNRZBRXEuiwZMsqARLH</guid>
            <pubDate>Sun, 18 Jan 2026 20:19:59 GMT</pubDate>
            <description><![CDATA[SurVet skinS - Dédé (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>SurVet skinS - Dédé (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="139926611" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/afb05ef9-d8e3-43f5-9552-88cae5114ad5?videoFileIds=5535943"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/nGinNRZBRXEuiwZMsqARLH"/>
            <media:player url="https://peertube2.cpy.re/w/nGinNRZBRXEuiwZMsqARLH"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1e396788-11d8-4a93-b681-844658d9ec5b-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b9c2bedf-d819-4e64-a571-11a30a20c076-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1674c9e5-d486-4fe5-91cb-0aeb504bff73-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e3d37f67-c8b1-454f-a5b3-532b17584199-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f6837562-f2be-4b1b-91fe-10ddae11d36b-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f4b23be6-400e-4aab-bbdc-64c16955be93-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="139926611" url="https://www.yiny.org/static/web-videos/fc43241a-06eb-4d97-a261-f9ba06557975-1080.mp4" framerate="30" duration="189" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="135170118" url="https://www.yiny.org/static/streaming-playlists/hls/afb05ef9-d8e3-43f5-9552-88cae5114ad5/3adcfc5a-82c4-4a34-8801-40ab9b909441-1080-fragmented.mp4" framerate="30" duration="189" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="69115142" url="https://www.yiny.org/static/streaming-playlists/hls/afb05ef9-d8e3-43f5-9552-88cae5114ad5/9bfd6448-6fef-4bd7-9131-c1d475619375-720-fragmented.mp4" framerate="30" duration="189" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="35631375" url="https://www.yiny.org/static/streaming-playlists/hls/afb05ef9-d8e3-43f5-9552-88cae5114ad5/a6f128ba-441a-4564-af3b-f8d511f20003-480-fragmented.mp4" framerate="30" duration="189" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="14703552" url="https://www.yiny.org/static/streaming-playlists/hls/afb05ef9-d8e3-43f5-9552-88cae5114ad5/1902f724-542c-434e-bd7e-014af0ddad81-240-fragmented.mp4" framerate="30" duration="189" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3092481" url="https://www.yiny.org/static/streaming-playlists/hls/afb05ef9-d8e3-43f5-9552-88cae5114ad5/65ebfd45-3d69-4318-a94f-2b4aaa3373e7-0-fragmented.mp4" framerate="0" duration="189" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/6d766d17-e9e3-4e6c-ad79-c01db0ae1306.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/c20944eb-eebf-47ff-9a30-7c931a9c61f1.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">SurVet skinS - Dédé - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">SurVet skinS - Dédé (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Wunderbach - Raya + Paris-Londres - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/qP42DFK4pmVVzh4ULggoNF</link>
            <guid>https://peertube2.cpy.re/w/qP42DFK4pmVVzh4ULggoNF</guid>
            <pubDate>Sun, 18 Jan 2026 20:18:40 GMT</pubDate>
            <description><![CDATA[Wunderbach - Raya + Paris-Londres - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Wunderbach - Raya + Paris-Londres - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="358199650" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/c8ed26c0-7c21-4216-bcee-1a2b3726d9f3?videoFileIds=5535941"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/qP42DFK4pmVVzh4ULggoNF"/>
            <media:player url="https://peertube2.cpy.re/w/qP42DFK4pmVVzh4ULggoNF"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4625598f-7957-487f-a1e7-012ba58e7c14-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a0b17452-b9d6-4a0b-ab8d-dcb8cd5a4abf-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ee25ec79-ea14-4274-9bf6-0b1221e844f2-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a9b3ab08-513b-4967-ba44-308be1d4c03f-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/61a14a03-5f0d-45b9-8b13-3ed043bdc0d3-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c1b23149-5818-4387-a104-51d53238c5fb-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="358199650" url="https://www.yiny.org/static/web-videos/73474feb-2ede-455f-bf1a-9b47cb5035bb-1080.mp4" framerate="30" duration="443" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="350651867" url="https://www.yiny.org/static/streaming-playlists/hls/c8ed26c0-7c21-4216-bcee-1a2b3726d9f3/68108ddd-1336-4ab9-a17b-946386c2e596-1080-fragmented.mp4" framerate="30" duration="443" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="175392260" url="https://www.yiny.org/static/streaming-playlists/hls/c8ed26c0-7c21-4216-bcee-1a2b3726d9f3/94af9ddb-41cf-4910-85e8-45fae86edb96-720-fragmented.mp4" framerate="30" duration="443" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="88942272" url="https://www.yiny.org/static/streaming-playlists/hls/c8ed26c0-7c21-4216-bcee-1a2b3726d9f3/77f83463-56b4-4885-abae-ae2f7bbbaf92-480-fragmented.mp4" framerate="30" duration="443" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="36282784" url="https://www.yiny.org/static/streaming-playlists/hls/c8ed26c0-7c21-4216-bcee-1a2b3726d9f3/e140b122-35ab-44d4-9632-a9c9e4c0f3f0-240-fragmented.mp4" framerate="30" duration="443" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="7247776" url="https://www.yiny.org/static/streaming-playlists/hls/c8ed26c0-7c21-4216-bcee-1a2b3726d9f3/938e9b20-6e98-464a-a7af-5a9cfe515fb3-0-fragmented.mp4" framerate="0" duration="443" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/d678bf41-fda9-45bb-8d1b-443bd05835a8.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/eeb49cbf-81dd-4807-8f2b-e097118bf0ab.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Wunderbach - Raya + Paris-Londres - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Wunderbach - Raya + Paris-Londres - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[SurVet skinS - Working Class Heroes - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/kfEA53shNFyMN8DUQAzkpx</link>
            <guid>https://peertube2.cpy.re/w/kfEA53shNFyMN8DUQAzkpx</guid>
            <pubDate>Sun, 18 Jan 2026 20:16:57 GMT</pubDate>
            <description><![CDATA[SurVet skinS - Working Class Heroes (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>SurVet skinS - Working Class Heroes (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="81869674" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/9be9d3e1-3694-45fe-9d75-9b8c024308c9?videoFileIds=5535932"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/kfEA53shNFyMN8DUQAzkpx"/>
            <media:player url="https://peertube2.cpy.re/w/kfEA53shNFyMN8DUQAzkpx"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4f886ff9-ed5f-4ee3-af73-11c7930062d6-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/38d6cfb7-18a0-49bc-9b6a-ac3604fbeeae-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/84b1f7d6-d791-4c3b-8ef8-8f5b0353a694-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/cd722ca0-dca5-401a-95f6-9b67a418f7ae-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c179d766-dac1-448b-9619-8da3c173f66c-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4d4f622c-e73d-43f2-946d-5730da79d376-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="81869674" url="https://www.yiny.org/static/web-videos/1c841ce7-501b-4b0c-8674-0f3fa2da6c3d-1080.mp4" framerate="28" duration="122" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="78043142" url="https://www.yiny.org/static/streaming-playlists/hls/9be9d3e1-3694-45fe-9d75-9b8c024308c9/0c1b8d56-0b79-4e9f-bdd5-7d69726b682b-1080-fragmented.mp4" framerate="28" duration="122" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="41521804" url="https://www.yiny.org/static/streaming-playlists/hls/9be9d3e1-3694-45fe-9d75-9b8c024308c9/2d72ff2c-6cb7-4fbb-bd74-567e134c6dfd-720-fragmented.mp4" framerate="28" duration="122" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="22015504" url="https://www.yiny.org/static/streaming-playlists/hls/9be9d3e1-3694-45fe-9d75-9b8c024308c9/1fe3fdc0-5a72-4587-983b-fbdd1391a7da-480-fragmented.mp4" framerate="28" duration="122" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="9120814" url="https://www.yiny.org/static/streaming-playlists/hls/9be9d3e1-3694-45fe-9d75-9b8c024308c9/d359b02a-f0c1-4908-9600-bb8821a3eed1-240-fragmented.mp4" framerate="28" duration="122" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1986593" url="https://www.yiny.org/static/streaming-playlists/hls/9be9d3e1-3694-45fe-9d75-9b8c024308c9/81aeba28-69de-446f-ad24-6b5d1268ae28-0-fragmented.mp4" framerate="0" duration="122" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/21f121f5-209e-48af-b484-357fd4dd9196.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/4acba9b4-a2e0-4dc1-8df6-0e70e5bc41e6.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">SurVet skinS - Working Class Heroes - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">SurVet skinS - Working Class Heroes (8°6 Crew) - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[SurVet skinS - Paris - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/nez38iqJAwpXnhie5W6Qch</link>
            <guid>https://peertube2.cpy.re/w/nez38iqJAwpXnhie5W6Qch</guid>
            <pubDate>Sun, 18 Jan 2026 20:15:37 GMT</pubDate>
            <description><![CDATA[SurVet skinS - Paris - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>SurVet skinS - Paris - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="97091054" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/abf4f0c0-0e19-4189-935f-d0210fbf7db6?videoFileIds=5535934"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/nez38iqJAwpXnhie5W6Qch"/>
            <media:player url="https://peertube2.cpy.re/w/nez38iqJAwpXnhie5W6Qch"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ccd4df3e-612f-4d8c-9146-86833f1ab0f0-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1c107c25-df4a-44eb-8457-26ea533e8427-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e9b76601-d351-4272-ae01-71a73d734b84-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/68b8db7e-db08-4a6e-a7fa-2033a43b718c-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/71911330-57f4-4428-be31-1f728b5c66ee-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="97091054" url="https://www.yiny.org/static/streaming-playlists/hls/abf4f0c0-0e19-4189-935f-d0210fbf7db6/1921635e-7e05-4045-953c-8e33016e5f40-1080-fragmented.mp4" framerate="30" duration="153" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="52336464" url="https://www.yiny.org/static/streaming-playlists/hls/abf4f0c0-0e19-4189-935f-d0210fbf7db6/e1ebbb44-f2b1-4d2a-9370-365b7874897b-720-fragmented.mp4" framerate="30" duration="153" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="28960382" url="https://www.yiny.org/static/streaming-playlists/hls/abf4f0c0-0e19-4189-935f-d0210fbf7db6/62a27e29-a2c5-43f0-a3fe-496297e87b50-480-fragmented.mp4" framerate="30" duration="153" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="11726769" url="https://www.yiny.org/static/streaming-playlists/hls/abf4f0c0-0e19-4189-935f-d0210fbf7db6/1382c0d3-40c8-40cd-b4ed-1c1237a42297-240-fragmented.mp4" framerate="30" duration="153" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2491780" url="https://www.yiny.org/static/streaming-playlists/hls/abf4f0c0-0e19-4189-935f-d0210fbf7db6/ca97b54a-60af-4e6a-b5a9-9566b1567a8e-0-fragmented.mp4" framerate="0" duration="153" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/c1b9d377-4941-4208-89c1-26d9222fa4f6.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/5c037f2c-bf12-43b3-81d2-cbb16f895cff.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">SurVet skinS - Paris - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">SurVet skinS - Paris - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Breakout - Post Tour Depression - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/8ALbmutD6HkyFvjpWJocY7</link>
            <guid>https://peertube2.cpy.re/w/8ALbmutD6HkyFvjpWJocY7</guid>
            <pubDate>Sun, 18 Jan 2026 20:13:56 GMT</pubDate>
            <description><![CDATA[Breakout - Post Tour Depression - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Breakout - Post Tour Depression - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="140035263" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/3d8a7c19-f3f0-4c13-8fcf-e3ecb994f8d2?videoFileIds=5535918"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/8ALbmutD6HkyFvjpWJocY7"/>
            <media:player url="https://peertube2.cpy.re/w/8ALbmutD6HkyFvjpWJocY7"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9e9ec718-c4ee-4958-8f33-d052cf4dc5cb-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a6a66c39-3309-4f99-9748-811fdf39f281-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f93e3f21-09fd-4ce3-a6ff-52fb8cf176d5-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/65af1fb5-f6be-4546-ab47-8edcf278d4ed-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4c914a95-4891-4009-bf65-18e4389be37b-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/38a32d36-8f5f-4e8b-844e-b3ac145076ed-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="140035263" url="https://www.yiny.org/static/web-videos/6f861767-0417-4087-a94a-817e422b66fe-1080.mp4" framerate="30" duration="173" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="135871970" url="https://www.yiny.org/static/streaming-playlists/hls/3d8a7c19-f3f0-4c13-8fcf-e3ecb994f8d2/48c81a63-287e-4224-9ec5-4f12a74a2310-1080-fragmented.mp4" framerate="30" duration="173" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="68086526" url="https://www.yiny.org/static/streaming-playlists/hls/3d8a7c19-f3f0-4c13-8fcf-e3ecb994f8d2/76052a07-08d6-440c-9125-385e55074abc-720-fragmented.mp4" framerate="30" duration="173" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="34821964" url="https://www.yiny.org/static/streaming-playlists/hls/3d8a7c19-f3f0-4c13-8fcf-e3ecb994f8d2/ccd75d40-0890-4716-b1c2-051855f5ecc4-480-fragmented.mp4" framerate="30" duration="173" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="14201565" url="https://www.yiny.org/static/streaming-playlists/hls/3d8a7c19-f3f0-4c13-8fcf-e3ecb994f8d2/bb4dc714-55d0-48d1-bdbb-b5051d5618ec-240-fragmented.mp4" framerate="30" duration="173" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2830161" url="https://www.yiny.org/static/streaming-playlists/hls/3d8a7c19-f3f0-4c13-8fcf-e3ecb994f8d2/559f6d26-962c-4399-bfde-1359bbd8d0cd-0-fragmented.mp4" framerate="0" duration="173" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/5a6558ec-92c2-4207-9e84-76b591cd8f4a.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/0d213ef6-e60d-419b-95ec-848a4db075a3.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Breakout - Post Tour Depression - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Breakout - Post Tour Depression - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Breakout - Spitting - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/mPKpqh2HbbT1kqFiu1CenE</link>
            <guid>https://peertube2.cpy.re/w/mPKpqh2HbbT1kqFiu1CenE</guid>
            <pubDate>Sun, 18 Jan 2026 20:13:35 GMT</pubDate>
            <description><![CDATA[Breakout - Spitting - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Breakout - Spitting - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="106134916" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/a8a17a99-ffe9-4a22-9cd5-5c7b5ecefc9c?videoFileIds=5535915"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/mPKpqh2HbbT1kqFiu1CenE"/>
            <media:player url="https://peertube2.cpy.re/w/mPKpqh2HbbT1kqFiu1CenE"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d097619b-cc5b-4099-9473-1659f235f7eb-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2c29e516-1193-4b1c-8866-cc4dfc5af61a-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/de227591-6d24-472b-9fe3-9a990e85e1e1-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3e7cbd51-c54f-4007-8b08-a6b2d09698e3-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/401bf4f4-4875-4fdd-b85f-c7c02958ba3a-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/08751121-9a83-432d-b95d-79ffa96e3a4f-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="106134916" url="https://www.yiny.org/static/web-videos/f7f2e31c-b3e6-4725-ab41-d5bcffe08284-1080.mp4" framerate="25" duration="176" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="102518178" url="https://www.yiny.org/static/streaming-playlists/hls/a8a17a99-ffe9-4a22-9cd5-5c7b5ecefc9c/2440f2e5-67c7-43ca-9d90-aa43cea89d0e-1080-fragmented.mp4" framerate="25" duration="176" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="54627652" url="https://www.yiny.org/static/streaming-playlists/hls/a8a17a99-ffe9-4a22-9cd5-5c7b5ecefc9c/ee95ab63-81b9-4bfe-b169-0daa49162e6a-720-fragmented.mp4" framerate="25" duration="176" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="29379123" url="https://www.yiny.org/static/streaming-playlists/hls/a8a17a99-ffe9-4a22-9cd5-5c7b5ecefc9c/842a36c7-e8b2-47e8-ae91-fd2f248691f8-480-fragmented.mp4" framerate="25" duration="176" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="12341700" url="https://www.yiny.org/static/streaming-playlists/hls/a8a17a99-ffe9-4a22-9cd5-5c7b5ecefc9c/a3592ff0-e6eb-4f56-9477-e239007f02ae-240-fragmented.mp4" framerate="25" duration="176" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2879388" url="https://www.yiny.org/static/streaming-playlists/hls/a8a17a99-ffe9-4a22-9cd5-5c7b5ecefc9c/9409d071-c120-4ab6-b38f-9b213fc200c2-0-fragmented.mp4" framerate="0" duration="176" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/7ed543b5-7f4b-4063-ab22-cf916cc39837.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/8616d073-e238-4bd4-8ed6-efa577d35bc9.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Breakout - Spitting - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Breakout - Spitting - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Breakout - Daily Disarray - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/qs4PhywwRwN5CjtioF5bop</link>
            <guid>https://peertube2.cpy.re/w/qs4PhywwRwN5CjtioF5bop</guid>
            <pubDate>Sun, 18 Jan 2026 20:11:29 GMT</pubDate>
            <description><![CDATA[Breakout - Daily Disarray - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Breakout - Daily Disarray - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="72882132" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/c5ff0460-ccb3-4c3c-9c10-922cc9322a0b?videoFileIds=5535909"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/qs4PhywwRwN5CjtioF5bop"/>
            <media:player url="https://peertube2.cpy.re/w/qs4PhywwRwN5CjtioF5bop"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/94332e93-8484-475b-8ca3-7d15b4a7d5f5-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/30f96792-794f-4291-8663-e00859b659dc-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/36543e55-9722-478a-a135-539b1074f821-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1bee93d9-d900-4fdf-9cf1-b555d6912766-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/dea8d92e-1809-40b7-8d1a-39ff1ae16a4e-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/80476ae0-5015-49db-9d5b-adef631fc542-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="72882132" url="https://www.yiny.org/static/web-videos/8cd22d1e-24f1-46ad-a919-00eaa96cf6d1-1080.mp4" framerate="29" duration="108" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="69260555" url="https://www.yiny.org/static/streaming-playlists/hls/c5ff0460-ccb3-4c3c-9c10-922cc9322a0b/d987c96d-62f3-41ca-b93a-cc2d1fbd9dc6-1080-fragmented.mp4" framerate="29" duration="108" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="36164924" url="https://www.yiny.org/static/streaming-playlists/hls/c5ff0460-ccb3-4c3c-9c10-922cc9322a0b/2b0f5ca2-c6c1-40ed-92d5-6d45a6ad394d-720-fragmented.mp4" framerate="29" duration="108" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="19714973" url="https://www.yiny.org/static/streaming-playlists/hls/c5ff0460-ccb3-4c3c-9c10-922cc9322a0b/f5282417-c3b1-446e-a7e7-1df398f620fe-480-fragmented.mp4" framerate="29" duration="108" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="7938869" url="https://www.yiny.org/static/streaming-playlists/hls/c5ff0460-ccb3-4c3c-9c10-922cc9322a0b/558dd3ec-65c6-46a2-9b1e-c174a928d1ac-240-fragmented.mp4" framerate="29" duration="108" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1760198" url="https://www.yiny.org/static/streaming-playlists/hls/c5ff0460-ccb3-4c3c-9c10-922cc9322a0b/dfff0ab0-9aa3-4e7b-be3f-6b937f0f749b-0-fragmented.mp4" framerate="0" duration="108" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/46bff7a4-1b5a-4767-8086-c12d7d0e8e13.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/274f670d-2031-48f8-8706-6a699be4723a.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Breakout - Daily Disarray - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Breakout - Daily Disarray - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Wunderbach - Les rues sont vides + SDF + 25 ans + Bons à rien (Prêts à tout) - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/fai4PeGzJHRdhdsFoG2oHP</link>
            <guid>https://peertube2.cpy.re/w/fai4PeGzJHRdhdsFoG2oHP</guid>
            <pubDate>Sun, 18 Jan 2026 20:09:05 GMT</pubDate>
            <description><![CDATA[Wunderbach - Les rues sont vides + SDF + 25 ans + Bons à rien (Prêts à tout) - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Wunderbach - Les rues sont vides + SDF + 25 ans + Bons à rien (Prêts à tout) - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="521013279" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/72ac26fe-8e44-4bdd-8e46-4d067e4f83b9?videoFileIds=5535906"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/fai4PeGzJHRdhdsFoG2oHP"/>
            <media:player url="https://peertube2.cpy.re/w/fai4PeGzJHRdhdsFoG2oHP"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d56689ab-6ca5-4ec7-b18d-f1efb9fdcfe0-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/805dbda7-7407-403f-b2d7-ef1db28cfb4a-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e67f9cde-8222-48a0-b6d6-0272ef6a4172-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/efb90e10-98d2-4b22-a095-24436de52c32-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/58621009-d516-406d-b8d6-1e41bb60b703-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/18e3d52a-39fc-49d3-94f1-349e14cf6700-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="521013279" url="https://www.yiny.org/static/web-videos/e03426eb-5520-47ff-aed2-daf98acb3828-1080.mp4" framerate="30" duration="642" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="509756088" url="https://www.yiny.org/static/streaming-playlists/hls/72ac26fe-8e44-4bdd-8e46-4d067e4f83b9/08dcf527-25b1-4e88-b096-6c5f5bd8cbea-1080-fragmented.mp4" framerate="30" duration="642" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="255106943" url="https://www.yiny.org/static/streaming-playlists/hls/72ac26fe-8e44-4bdd-8e46-4d067e4f83b9/3650c81b-a757-45e0-bb6b-64ec3cba8be5-720-fragmented.mp4" framerate="30" duration="642" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="129177883" url="https://www.yiny.org/static/streaming-playlists/hls/72ac26fe-8e44-4bdd-8e46-4d067e4f83b9/ce09bd7b-2c90-44ed-854b-f19dc0d3ff48-480-fragmented.mp4" framerate="30" duration="642" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="52693410" url="https://www.yiny.org/static/streaming-playlists/hls/72ac26fe-8e44-4bdd-8e46-4d067e4f83b9/3b2077fc-2782-43e7-8ec7-4b38edc9478d-240-fragmented.mp4" framerate="30" duration="642" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="10497679" url="https://www.yiny.org/static/streaming-playlists/hls/72ac26fe-8e44-4bdd-8e46-4d067e4f83b9/b2383c74-5bb8-44ea-8d01-f08733187a19-0-fragmented.mp4" framerate="0" duration="642" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/2c1deccc-aed7-4959-8128-dc76a9035bfe.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/01ca6f7c-cc1f-4159-b9a2-1a6d84188556.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Wunderbach - Les rues sont vides + SDF + 25 ans + Bons à rien (Prêts à tout) - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Wunderbach - Les rues sont vides + SDF + 25 ans + Bons à rien (Prêts à tout) - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Breakout - Lost - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/79WL3poXxAqriGZxyf7QdQ</link>
            <guid>https://peertube2.cpy.re/w/79WL3poXxAqriGZxyf7QdQ</guid>
            <pubDate>Sun, 18 Jan 2026 20:05:52 GMT</pubDate>
            <description><![CDATA[Breakout - Lost - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Breakout - Lost - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="114983728" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/31d6875c-c41d-40dd-9b35-dd003e2d5fb8?videoFileIds=5535899"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/79WL3poXxAqriGZxyf7QdQ"/>
            <media:player url="https://peertube2.cpy.re/w/79WL3poXxAqriGZxyf7QdQ"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/46ea23c9-ca33-47e9-813b-819a4b90f331-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d543bbaa-fbbb-40fd-ad26-4b4d79a435a7-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e538b73d-e048-42fa-9f8f-ef601b84e3ef-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ba70d31e-0cbc-4ee9-b6d1-9444ad02af75-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6f3c7326-8e6f-409d-9be2-501957dfdfff-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6bccc9f1-fdeb-4efb-ab5a-7fea68fa4498-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="114983728" url="https://www.yiny.org/static/web-videos/ce84bd62-96a6-44e2-95b8-31c9d75d684f-1080.mp4" framerate="30" duration="156" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="106479346" url="https://www.yiny.org/static/streaming-playlists/hls/31d6875c-c41d-40dd-9b35-dd003e2d5fb8/55d4f794-d238-4c55-99de-59aac1bba5ab-1080-fragmented.mp4" framerate="30" duration="156" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="56011229" url="https://www.yiny.org/static/streaming-playlists/hls/31d6875c-c41d-40dd-9b35-dd003e2d5fb8/ee8f0f87-f058-4b7e-aff5-c7c33a038ebe-720-fragmented.mp4" framerate="30" duration="156" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="30393717" url="https://www.yiny.org/static/streaming-playlists/hls/31d6875c-c41d-40dd-9b35-dd003e2d5fb8/312deb43-f6b2-41d0-b15c-ee2badb5fa46-480-fragmented.mp4" framerate="30" duration="156" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="12009440" url="https://www.yiny.org/static/streaming-playlists/hls/31d6875c-c41d-40dd-9b35-dd003e2d5fb8/8405acbe-6c63-4dab-85f7-e698a1ec09be-240-fragmented.mp4" framerate="30" duration="156" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2560535" url="https://www.yiny.org/static/streaming-playlists/hls/31d6875c-c41d-40dd-9b35-dd003e2d5fb8/29f63410-c28b-4cf4-8527-a462de99c029-0-fragmented.mp4" framerate="0" duration="156" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/ba33c8a8-bab1-4ecb-b1a3-5d027fe33bf8.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/508ed24a-45c4-4dac-8d05-6671db21b367.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Breakout - Lost - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Breakout - Lost - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Breakout - Their Control Fades Away - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/9XN5dbuvXB2ekpyEcJM3t9</link>
            <guid>https://peertube2.cpy.re/w/9XN5dbuvXB2ekpyEcJM3t9</guid>
            <pubDate>Sun, 18 Jan 2026 20:03:36 GMT</pubDate>
            <description><![CDATA[Breakout - Their Control Fades Away - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Breakout - Their Control Fades Away - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="112864259" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/489368ed-3ffe-4ea2-ba25-14f070da9a76?videoFileIds=5535901"/>
            <media:community>
                <media:statistics views="1"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/9XN5dbuvXB2ekpyEcJM3t9"/>
            <media:player url="https://peertube2.cpy.re/w/9XN5dbuvXB2ekpyEcJM3t9"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c0572d2d-632a-446f-ac28-a82dda7f3238-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/03774002-19ab-49d5-8e87-9f3c4da083ef-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4c0e65b5-f95c-4aff-b5d9-daeb9fb111ce-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4e90784f-f251-4f32-afca-bc0d113e5c22-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d0ff18b1-002b-43e8-b573-41e95c35f06d-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="112864259" url="https://www.yiny.org/static/streaming-playlists/hls/489368ed-3ffe-4ea2-ba25-14f070da9a76/f37fa8f3-0a15-4d11-bcf8-88f353b802c8-1080-fragmented.mp4" framerate="30" duration="145" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="56999391" url="https://www.yiny.org/static/streaming-playlists/hls/489368ed-3ffe-4ea2-ba25-14f070da9a76/30da751a-14e1-4baa-a61b-021ae0e576d7-720-fragmented.mp4" framerate="30" duration="145" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="29069824" url="https://www.yiny.org/static/streaming-playlists/hls/489368ed-3ffe-4ea2-ba25-14f070da9a76/89791edb-dda2-44c9-9b89-48a0f530450d-480-fragmented.mp4" framerate="30" duration="145" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="11823731" url="https://www.yiny.org/static/streaming-playlists/hls/489368ed-3ffe-4ea2-ba25-14f070da9a76/12c1036a-4fa8-468a-be28-3e0773e5487f-240-fragmented.mp4" framerate="30" duration="145" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2376066" url="https://www.yiny.org/static/streaming-playlists/hls/489368ed-3ffe-4ea2-ba25-14f070da9a76/337071a1-0bad-4db9-825e-cec72441a85b-0-fragmented.mp4" framerate="0" duration="145" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/90491945-ac1f-47b3-8a5f-ac5077a5f8e5.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/7e60ce49-213b-4799-a055-128ef983df5a.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Breakout - Their Control Fades Away - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Breakout - Their Control Fades Away - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
        <item>
            <title><![CDATA[Breakout - Stuck in Berlin - Montreuil - 10/01/2026]]></title>
            <link>https://peertube2.cpy.re/w/fhGUQUdiERBSy5WdiHMfcm</link>
            <guid>https://peertube2.cpy.re/w/fhGUQUdiERBSy5WdiHMfcm</guid>
            <pubDate>Sun, 18 Jan 2026 20:01:19 GMT</pubDate>
            <description><![CDATA[Breakout - Stuck in Berlin - La Marbrerie, Montreuil - 10 janvier 2026]]></description>
            <content:encoded><![CDATA[<p>Breakout - Stuck in Berlin - La Marbrerie, Montreuil - 10 janvier 2026</p>
]]></content:encoded>
            <dc:creator>flo200</dc:creator>
            <category>Music</category>
            <enclosure length="138984425" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/73b50dcd-494a-48f2-a7b6-75d5ac7110c2?videoFileIds=5535888"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/fhGUQUdiERBSy5WdiHMfcm"/>
            <media:player url="https://peertube2.cpy.re/w/fhGUQUdiERBSy5WdiHMfcm"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2236934c-5fac-4f21-b6df-bc9b4142066d-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/32a065ee-323f-4166-948c-48d87e1b709b-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ffa5cf6a-5c1d-4f7a-98e0-57588b1c1181-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/12289a9e-9133-45b1-88b8-b433750b0c26-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1fbdafd7-d877-4fa4-89e4-ee229d5de002-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/030aad77-3f24-4cec-bb7e-a23cf2a1688f-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="138984425" url="https://www.yiny.org/static/web-videos/7c70ceb0-d165-4b5e-adb5-73f95c4a1e95-1080.mp4" framerate="30" duration="176" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="134386928" url="https://www.yiny.org/static/streaming-playlists/hls/73b50dcd-494a-48f2-a7b6-75d5ac7110c2/d0bebba1-8bab-49d3-b6cd-9847a9c8ee95-1080-fragmented.mp4" framerate="30" duration="176" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="67298464" url="https://www.yiny.org/static/streaming-playlists/hls/73b50dcd-494a-48f2-a7b6-75d5ac7110c2/8c0f1bf7-e992-4d74-a1a3-47f5a0830d70-720-fragmented.mp4" framerate="30" duration="176" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="34566622" url="https://www.yiny.org/static/streaming-playlists/hls/73b50dcd-494a-48f2-a7b6-75d5ac7110c2/56608a97-2ea7-45ca-afc1-d2fe811494c9-480-fragmented.mp4" framerate="30" duration="176" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="14046102" url="https://www.yiny.org/static/streaming-playlists/hls/73b50dcd-494a-48f2-a7b6-75d5ac7110c2/db46742b-d2e3-4efc-b71a-1e7532f07a6c-240-fragmented.mp4" framerate="30" duration="176" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="2892726" url="https://www.yiny.org/static/streaming-playlists/hls/73b50dcd-494a-48f2-a7b6-75d5ac7110c2/69b140ae-aab1-4bb8-a5e9-06bf3f5ba60b-0-fragmented.mp4" framerate="0" duration="176" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/3645d299-f3f0-4a42-b5f6-3d7366b279b5.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/865a1121-1c3a-454d-9a2a-0f4b5546acd1.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Breakout - Stuck in Berlin - Montreuil - 10/01/2026</media:title>
            <media:description type="plain">Breakout - Stuck in Berlin - La Marbrerie, Montreuil - 10 janvier 2026</media:description>
        </item>
    </channel>
</rss>

Videos of subscriptions feeds

path Parameters
format
required
string
Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1"

format expected (we focus on making rss the most feature-rich ; it serves Media RSS)

query Parameters
accountId
required
string

limit listing to a specific account

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

sort
string
Example: sort=-createdAt

Sort column

token
required
string

private token allowing access

Responses

Response samples

Content type
No sample

Videos podcast feed

query Parameters
videoChannelId
required
string

Limit listing to a specific video channel

Responses

Register

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 instead.

Resend user verification link

Request Body schema: application/json
email
required
string

User email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Resend verification link to registration request email

Request Body schema: application/json
email
required
string

Registration email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Verify a user

Following a user registration, the new user will receive an email asking to click a link containing a secret. This endpoint can also be used to verify a new email set in the user account.

path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
verificationString
required
string <url>
isPendingEmail
boolean

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string",
  • "isPendingEmail": true
}

Verify a registration email

Following a user registration request, the user will receive an email asking to click a link containing a secret.

path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Request Body schema: application/json
verificationString
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string"
}

Register a user

Signup has to be enabled and signup approval is not required

Request Body schema: application/json
required
email
required
string <email>

email of the user, used for login or service communications

password
required
string <password> (password) [ 6 .. 50 ] characters
username
required
string [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

object

channel base information used to create the first channel of the user

displayName
string [ 1 .. 120 ] characters

editable name of the user, displayed in its representations

Responses

Request samples

Content type
application/json
{
  • "username": "chocobozzz",
  • "password": "pa$$word",
  • "email": "user@example.com",
  • "displayName": "string",
  • "channel": {
    }
}

Request registration

Signup has to be enabled and require approval on the instance

Request Body schema: application/json
email
required
string <email>

email of the user, used for login or service communications

password
required
string <password> (password) [ 6 .. 50 ] characters
registrationReason
required
string

reason for the user to register on the instance

username
required
string [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

object

channel base information used to create the first channel of the user

displayName
string [ 1 .. 120 ] characters

editable name of the user, displayed in its representations

Responses

Request samples

Content type
application/json
{
  • "username": "chocobozzz",
  • "password": "pa$$word",
  • "email": "user@example.com",
  • "displayName": "string",
  • "channel": {
    },
  • "registrationReason": "string"
}

Response samples

Content type
application/json
{
  • "id": 42,
  • "state": {
    },
  • "registrationReason": "string",
  • "moderationResponse": "string",
  • "username": "string",
  • "email": "user@example.com",
  • "emailVerified": true,
  • "accountDisplayName": "string",
  • "channelHandle": "string",
  • "channelDisplayName": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "user": {
    }
}

Accept registration

Authorizations:
OAuth2
path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Request Body schema: application/json
moderationResponse
required
string

Moderation response to send to the user

preventEmailDelivery
boolean

Set it to true if you don't want PeerTube to send an email to the user

Responses

Request samples

Content type
application/json
{
  • "moderationResponse": "string",
  • "preventEmailDelivery": true
}

Reject registration

Authorizations:
OAuth2
path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Request Body schema: application/json
moderationResponse
required
string

Moderation response to send to the user

preventEmailDelivery
boolean

Set it to true if you don't want PeerTube to send an email to the user

Responses

Request samples

Content type
application/json
{
  • "moderationResponse": "string",
  • "preventEmailDelivery": true
}

Delete registration

Delete the registration entry. It will not remove the user associated with this registration (if any)

Authorizations:
OAuth2
path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Responses

List registrations

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string
sort
string
Enum: "-createdAt" "createdAt" "state" "-state"
start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Login/Logout

Sessions deal with access tokens over time. Only one session token can currently be used at a time.

Login prerequisite

You need to retrieve a client id and secret before logging in.

Responses

Request samples 

API="https://peertube2.cpy.re/api/v1"

## AUTH
curl -s "$API/oauth-clients/local"

Response samples

Content type
application/json
{
  • "client_id": "v1ikx5hnfop4mdpnci8nsqh93c45rldf",
  • "client_secret": "AjWiOapPltI6EnsWQwlFarRtLh4u8tDt"
}

Login

With your client id and secret, you can retrieve an access and refresh tokens.

header Parameters
x-peertube-otp
string

If the user enabled two factor authentication, you need to provide the OTP code in this header

Request Body schema: application/x-www-form-urlencoded
client_id
required
string = 32 characters /^[a-z0-9]$/
client_secret
required
string = 32 characters /^[a-zA-Z0-9]$/
grant_type
required
string
username
required
string [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

externalAuthToken
string

If you want to authenticate using an external authentication token you got from an auth plugin (like peertube-plugin-auth-openid-connect for example) instead of a password or a refresh token, provide it here.

password
string <password> (password) [ 6 .. 50 ] characters

Responses

Request samples 

## DEPENDENCIES: jq
API="https://peertube2.cpy.re/api/v1"
USERNAME="<your_username>"
PASSWORD="<your_password>"

## AUTH
client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret")
curl -s "$API/users/token" \
  --data client_id="$client_id" \
  --data client_secret="$client_secret" \
  --data grant_type=password \
  --data username="$USERNAME" \
  --data-urlencode password="$PASSWORD" \
  | jq -r ".access_token"

Response samples

Content type
application/json
{
  • "token_type": "Bearer",
  • "access_token": "90286a0bdf0f7315d9d3fe8dabf9e1d2be9c97d0",
  • "refresh_token": "2e0d675df9fc96d2e4ec8a3ebbbf45eca9137bb7",
  • "expires_in": 14399,
  • "refresh_token_expires_in": 1209600
}

Logout

Revokes your access token and its associated refresh token, destroying your current session.

Authorizations:
OAuth2

Responses

List token sessions

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List token sessions

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

tokenSessionId
required
integer (id) >= 1
Example: 42

Token session Id

Responses

Accounts

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 comment is posted, it is done with your Account's Actor.

Get an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "url": "string",
  • "name": "chocobozzz",
  • "avatars": [
    ],
  • "host": "example.com",
  • "hostRedundancyAllowed": true,
  • "followingCount": 0,
  • "followersCount": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "userId": 42,
  • "displayName": "string",
  • "description": "string"
}

List videos of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Request samples 

fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')
.then(function(response) {
  return response.json()
}).then(function(data) {
  console.log(data)
})

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List followers of an account

Authorizations:
OAuth2
path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Value: "createdAt"

Sort followers by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List accounts

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List playlists of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
string or Array of strings

PeerTube >= 8.0 Filter on playlists that are published on a channel with one of these names

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

withStats
boolean

include daily view statistics for the last 30 days and total views (only if authenticated as the account user)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List the synchronizations of video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List ratings of an account

Authorizations:
OAuth2
path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

rating
string
Enum: "like" "dislike"

Optionally filter which ratings to retrieve

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Users

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 corresponding local Account for federation.

Create a user

Authorizations:
OAuth2
Request Body schema: application/json
required

If the smtp server is configured, you can leave the password empty and an email will be sent asking the user to set it first.

email
required
string <email>

The user email

password
required
string <password> (password) [ 6 .. 50 ] characters
role
required
integer (UserRole)
Enum: 0 1 2

The user role (Admin = 0, Moderator = 1, User = 2)

username
required
string (username) [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

adminFlags
integer (UserAdminFlags)
Enum: 0 1

Admin flags for the user (None = 0, Bypass video blocklist = 1)

channelName
string (usernameChannel) [ 1 .. 50 ] characters /^[a-zA-Z0-9\\-_.:]+$/

immutable name of the channel, used to interact with its actor

videoQuota
integer

The user video quota in bytes

videoQuotaDaily
integer

The user daily video quota in bytes

Responses

Request samples

Content type
application/json
{
  • "username": "chocobozzz",
  • "password": "pa$$word",
  • "email": "user@example.com",
  • "videoQuota": -1,
  • "videoQuotaDaily": -1,
  • "channelName": "framasoft_videos",
  • "role": 2,
  • "adminFlags": 1
}

Response samples

Content type
application/json
{
  • "user": {
    }
}

List users

Authorizations:
OAuth2
query Parameters
blocked
boolean

Filter results down to (un)banned users

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search that will match with user usernames or emails

sort
string
Enum: "-id" "-username" "-createdAt"

Sort users by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Get a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

query Parameters
withStats
boolean

include statistics about the user (only available as a moderator/admin)

Responses

Response samples

Content type
application/json
Example
{
  • "id": 42,
  • "username": "chocobozzz",
  • "email": "user@example.com",
  • "emailVerified": true,
  • "emailPublic": true,
  • "nsfwPolicy": "display",
  • "nsfwFlagsDisplayed": 0,
  • "nsfwFlagsHidden": 0,
  • "nsfwFlagsWarned": 0,
  • "nsfwFlagsBlurred": 0,
  • "adminFlags": 1,
  • "autoPlayNextVideo": true,
  • "autoPlayNextVideoPlaylist": true,
  • "autoPlayVideo": true,
  • "p2pEnabled": true,
  • "videosHistoryEnabled": true,
  • "videoLanguages": [
    ],
  • "language": "string",
  • "videoQuota": -1,
  • "videoQuotaDaily": -1,
  • "role": {
    },
  • "theme": "string",
  • "account": {
    },
  • "notificationSettings": {
    },
  • "videoChannels": [
    ],
  • "blocked": true,
  • "blockedReason": "string",
  • "noInstanceConfigWarningModal": true,
  • "noAccountSetupWarningModal": true,
  • "noWelcomeModal": true,
  • "createdAt": "string",
  • "pluginAuth": "string",
  • "lastLoginDate": "2019-08-24T14:15:22Z",
  • "twoFactorEnabled": true,
  • "newFeaturesInfoRead": 0
}

Update a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
required
adminFlags
integer (UserAdminFlags)
Enum: 0 1

Admin flags for the user (None = 0, Bypass video blocklist = 1)

email
string <email>

The updated email of the user

emailVerified
boolean

Set the email as verified

password
string <password> (password) [ 6 .. 50 ] characters
pluginAuth
string or null

The auth plugin to use to authenticate the user

role
integer (UserRole)
Enum: 0 1 2

The user role (Admin = 0, Moderator = 1, User = 2)

videoQuota
integer

The updated video quota of the user in bytes

videoQuotaDaily
integer

The updated daily video quota of the user in bytes

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "emailVerified": true,
  • "videoQuota": 0,
  • "videoQuotaDaily": 0,
  • "pluginAuth": "peertube-plugin-auth-saml2",
  • "role": 2,
  • "adminFlags": 1,
  • "password": "pa$$word"
}

Resend user verification link

Request Body schema: application/json
email
required
string

User email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Verify a user

Following a user registration, the new user will receive an email asking to click a link containing a secret. This endpoint can also be used to verify a new email set in the user account.

path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
verificationString
required
string <url>
isPendingEmail
boolean

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string",
  • "isPendingEmail": true
}

Ask to reset password

An email containing a reset password link

Request Body schema: application/json
email
required
string

User email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Reset password

path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
password
required
string
verificationString
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string",
  • "password": "string"
}

Request two factor auth

Request two factor authentication for a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
currentPassword
string

Password of the currently authenticated user

Responses

Request samples

Content type
application/json
{
  • "currentPassword": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

Confirm two factor auth

Confirm a two factor authentication request

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
otpToken
required
string

OTP token generated by the app

requestToken
required
string

Token to identify the two factor request

Responses

Request samples

Content type
application/json
{
  • "requestToken": "string",
  • "otpToken": "string"
}

Disable two factor auth

Disable two factor authentication of a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
currentPassword
string

Password of the currently authenticated user

Responses

Request samples

Content type
application/json
{
  • "currentPassword": "string"
}

User Exports

To create an archive of user data.

Request user export

Request an archive of user data. An email is sent when the archive is ready.

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

Request Body schema: application/json
withVideoFiles
boolean

Whether to include video files in the archive

Responses

Request samples

Content type
application/json
{
  • "withVideoFiles": true
}

Response samples

Content type
application/json
{
  • "export": {
    }
}

List user exports

PeerTube >= 6.1

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "state": {
    },
  • "size": 0,
  • "privateDownloadUrl": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "expiresOn": "2019-08-24T14:15:22Z"
}

Delete a user export

PeerTube >= 6.1

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

userId
required
integer (id) >= 1
Example: 42

User id

Responses

User Imports

To import an archive of user data.

Initialize the resumable user import

PeerTube >= 6.1 Uses a resumable protocol to initialize the import of the archive

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
filename
string <filename>

Archive filename including extension

Responses

Request samples

Content type
application/json
{
  • "filename": "user-export-6-2024-02-09T10_12_11.682Z"
}

Send chunk for the resumable user import

PeerTube >= 6.1 Uses a resumable protocol to continue, pause or resume the import of the archive

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

Request Body schema: application/octet-stream
string <binary>

Responses

Cancel the resumable user import

PeerTube >= 6.1 Uses a resumable protocol to cancel the resumable user import

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Get latest user import

PeerTube >= 6.1

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "state": {
    },
  • "createdAt": "2019-08-24T14:15:22Z"
}

My User

Operations related to your own User, when logged-in.

Get my user information

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update my user information

Authorizations:
OAuth2
Request Body schema: application/json
required
autoPlayNextVideo
boolean

new preference regarding playing following videos automatically

autoPlayNextVideoPlaylist
boolean

new preference regarding playing following playlist videos automatically

autoPlayVideo
boolean

new preference regarding playing videos automatically

currentPassword
string <password> (password) [ 6 .. 50 ] characters
displayName
string [ 3 .. 120 ] characters

new name of the user in its representations

email
string <email>

new email used for login and service communications

language
string

default language for this user

noAccountSetupWarningModal
boolean
noInstanceConfigWarningModal
boolean
noWelcomeModal
boolean
nsfwFlagsBlurred
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsDisplayed
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsHidden
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsWarned
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwPolicy
string
Enum: "true" "false" "both"

new NSFW display policy

p2pEnabled
boolean

whether to enable P2P in the player or not

password
string <password> (password) [ 6 .. 50 ] characters
theme
string
videoLanguages
Array of strings

list of languages to filter videos down to

videosHistoryEnabled
boolean

whether to keep track of watched history or not

Responses

Request samples

Content type
application/json
{
  • "password": "pa$$word",
  • "currentPassword": "pa$$word",
  • "email": "user@example.com",
  • "displayName": "string",
  • "nsfwPolicy": "true",
  • "nsfwFlagsDisplayed": 0,
  • "nsfwFlagsHidden": 0,
  • "nsfwFlagsWarned": 0,
  • "nsfwFlagsBlurred": 0,
  • "p2pEnabled": true,
  • "autoPlayVideo": true,
  • "autoPlayNextVideo": true,
  • "autoPlayNextVideoPlaylist": true,
  • "videosHistoryEnabled": true,
  • "videoLanguages": [
    ],
  • "language": "string",
  • "theme": "string",
  • "noInstanceConfigWarningModal": true,
  • "noAccountSetupWarningModal": true,
  • "noWelcomeModal": true
}

Get video imports of my user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

search
string

Search in video names

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

targetUrl
string

Filter on import target URL

videoChannelSyncId
number

Filter on imports created by a specific channel synchronization

videoId
integer

Filter on import video ID

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Get my user used quota

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "videoQuotaUsed": 16810141515,
  • "videoQuotaUsedDaily": 1681014151
}

Get rate of my user for a video

Authorizations:
OAuth2
path Parameters
videoId
required
integer >= 1
Example: 42

The video id

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "rating": "like"
}

List videos of my user

Authorizations:
OAuth2
query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

string or Array of strings

PeerTube >= 7.2 Filter on videos that are published by a channel with one of these names

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Mark feature info as read

**PeerTube >= v8.0.0

Authorizations:
OAuth2
Request Body schema: application/json
feature
required
integer (NewFeatureInfoType)
Value: 1

Represent a new feature that can be displayed to inform users. One of the following values:

  • 1 CHANNEL_COLLABORATION

Responses

Request samples

Content type
application/json
{
  • "feature": 1
}

Update my user avatar

Authorizations:
OAuth2
Request Body schema: multipart/form-data
avatarfile
string <binary>

The file to upload

Responses

Response samples

Content type
application/json
{
  • "avatars": [
    ]
}

Delete my avatar

Authorizations:
OAuth2

Responses

List my abuses

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

id
integer

only list the report with this id

sort
string
Enum: "-id" "-createdAt" "-state"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

My Subscriptions

Operations related to your subscriptions to video channels, their new videos, and how to keep up to date with their latest publications!

List my user subscriptions

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-id" "-createdAt" "-channelUpdatedAt"
start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add subscription to my user

Authorizations:
OAuth2
Request Body schema: application/json
uri
required
string <uri>

uri of the video channels to subscribe to

Responses

Request samples

Content type
application/json
{
  • "uri": "008a0e54-375d-49d0-8379-143202e24152@video.lqdn.fr"
}

Get if subscriptions exist for my user

Authorizations:
OAuth2
query Parameters
uris
required
Array of strings <uri> [ items <uri > ]

list of uris to check if each is part of the user subscriptions

Responses

Response samples

Content type
application/json
{ }

List videos of subscriptions of my user

Authorizations:
OAuth2
query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Get subscription of my user

Authorizations:
OAuth2
path Parameters
subscriptionHandle
required
string
Example: my_username | my_username@example.com

The subscription handle

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "url": "string",
  • "name": "chocobozzz",
  • "avatars": [
    ],
  • "host": "example.com",
  • "hostRedundancyAllowed": true,
  • "followingCount": 0,
  • "followersCount": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "displayName": "Videos of Framasoft",
  • "description": "Videos made with <3 by Framasoft",
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "isLocal": true,
  • "banners": [
    ],
  • "ownerAccount": {
    }
}

Delete subscription of my user

Authorizations:
OAuth2
path Parameters
subscriptionHandle
required
string
Example: my_username | my_username@example.com

The subscription handle

Responses

My Notifications

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-notification type delivery preference, to receive the info either by mail, by in-browser notification or both.

List my notifications

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

typeOneOf
Array of integers (NotificationType)
Items Enum: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

only list notifications of these types

unread
boolean

only list unread notifications

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Mark notifications as read by their id

Authorizations:
OAuth2
Request Body schema: application/json
ids
required
Array of integers

ids of the notifications to mark as read

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ]
}

Mark all my notification as read

Authorizations:
OAuth2

Responses

Update my notification settings

Authorizations:
OAuth2
Request Body schema: application/json
abuseAsModerator
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
abuseNewMessage
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
abuseStateChange
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
autoInstanceFollowing
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
blacklistOnMyVideo
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
commentMention
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoImportFinished
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoPublished
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoStudioEditionFinished
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoTranscriptionGenerated
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newCommentOnMyVideo
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newFollow
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newInstanceFollower
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newPeerTubeVersion
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newPluginVersion
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newUserRegistration
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newVideoFromSubscription
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
videoAutoBlacklistAsModerator
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL

Responses

Request samples

Content type
application/json
{
  • "abuseAsModerator": 0,
  • "videoAutoBlacklistAsModerator": 0,
  • "newUserRegistration": 0,
  • "newVideoFromSubscription": 0,
  • "blacklistOnMyVideo": 0,
  • "myVideoPublished": 0,
  • "myVideoImportFinished": 0,
  • "commentMention": 0,
  • "newCommentOnMyVideo": 0,
  • "newFollow": 0,
  • "newInstanceFollower": 0,
  • "autoInstanceFollowing": 0,
  • "abuseStateChange": 0,
  • "abuseNewMessage": 0,
  • "newPeerTubeVersion": 0,
  • "newPluginVersion": 0,
  • "myVideoStudioEditionFinished": 0,
  • "myVideoTranscriptionGenerated": 0
}

My History

Operations related to your watch history.

List watched videos history

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Delete history element

Authorizations:
OAuth2
path Parameters
videoId
required
integer >= 1
Example: 42

object id for the video

Responses

Clear video history

Authorizations:
OAuth2
Request Body schema: multipart/form-data
beforeDate
string <date-time>

history before this date will be deleted

Responses

Video

Operations dealing with listing, uploading, fetching or modifying videos.

List videos of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Request samples 

fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')
.then(function(response) {
  return response.json()
}).then(function(data) {
  console.log(data)
})

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Request video token

Request special tokens that expire quickly to use them in some context (like accessing private static files)

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "files": {
    }
}

Create a studio task

Create a task to edit a video (cut, add intro/outro etc)

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
required
Array
Any of
name
string
Value: "cut"
object

Responses

List videos

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List available video categories

Responses

Response samples

Content type
application/json
{
  • "1": "Music",
  • "2": "Films",
  • "3": "Vehicles",
  • "4": "Art",
  • "5": "Sports",
  • "6": "Travels",
  • "7": "Gaming",
  • "8": "People",
  • "9": "Comedy",
  • "10": "Entertainment",
  • "11": "News & Politics",
  • "12": "How To",
  • "13": "Education",
  • "14": "Activism",
  • "15": "Science & Technology",
  • "16": "Animals",
  • "17": "Kids",
  • "18": "Food"
}

List available video licences

Responses

Response samples

Content type
application/json
{
  • "1": "Attribution",
  • "2": "Attribution - Share Alike",
  • "3": "Attribution - No Derivatives",
  • "4": "Attribution - Non Commercial",
  • "5": "Attribution - Non Commercial - Share Alike",
  • "6": "Attribution - Non Commercial - No Derivatives",
  • "7": "Public Domain Dedication",
  • "8": "Free of known copyright restrictions",
  • "9": "Copyrighted - All Rights Reserved"
}

List available video languages

Responses

Response samples

Content type
application/json
{
  • "aa": "Afar",
  • "ab": "Abkhazian",
  • "af": "Afrikaans",
  • "ak": "Akan",
  • "am": "Amharic",
  • "ar": "Arabic",
  • "an": "Aragonese",
  • "ase": "American Sign Language",
  • "as": "Assamese",
  • "asq": "Austrian Sign Language",
  • "av": "Avaric",
  • "avk": "Kotava",
  • "ay": "Aymara",
  • "az": "Azerbaijani",
  • "ba": "Bashkir",
  • "bm": "Bambara",
  • "be": "Belarusian",
  • "bn": "Bengali",
  • "bfi": "British Sign Language",
  • "bi": "Bislama",
  • "bo": "Tibetan",
  • "bs": "Bosnian",
  • "br": "Breton",
  • "bg": "Bulgarian",
  • "bzs": "Brazilian Sign Language",
  • "ca": "Catalan",
  • "cs": "Czech",
  • "ch": "Chamorro",
  • "ce": "Chechen",
  • "cv": "Chuvash",
  • "kw": "Cornish",
  • "co": "Corsican",
  • "cr": "Cree",
  • "cse": "Czech Sign Language",
  • "csl": "Chinese Sign Language",
  • "cy": "Welsh",
  • "da": "Danish",
  • "de": "German",
  • "dv": "Dhivehi",
  • "dsl": "Danish Sign Language",
  • "dz": "Dzongkha",
  • "el": "Greek",
  • "en": "English",
  • "eo": "Esperanto",
  • "et": "Estonian",
  • "eu": "Basque",
  • "ee": "Ewe",
  • "fo": "Faroese",
  • "fa": "Persian",
  • "fj": "Fijian",
  • "fi": "Finnish",
  • "fr": "French",
  • "fy": "Western Frisian",
  • "fse": "Finnish Sign Language",
  • "fsl": "French Sign Language",
  • "ff": "Fulah",
  • "gcf": "Guadeloupean Creole French",
  • "gd": "Scottish Gaelic",
  • "ga": "Irish",
  • "gl": "Galician",
  • "gv": "Manx",
  • "gn": "Guarani",
  • "gsg": "German Sign Language",
  • "gsw": "Swiss German",
  • "gu": "Gujarati",
  • "ht": "Haitian",
  • "ha": "Hausa",
  • "sh": "Serbo-Croatian",
  • "he": "Hebrew",
  • "hz": "Herero",
  • "hi": "Hindi",
  • "ho": "Hiri Motu",
  • "hr": "Croatian",
  • "hu": "Hungarian",
  • "hy": "Armenian",
  • "ig": "Igbo",
  • "ii": "Sichuan Yi",
  • "iu": "Inuktitut",
  • "id": "Indonesian",
  • "ik": "Inupiaq",
  • "is": "Icelandic",
  • "it": "Italian",
  • "jv": "Javanese",
  • "jbo": "Lojban",
  • "ja": "Japanese",
  • "jsl": "Japanese Sign Language",
  • "kab": "Kabyle",
  • "kl": "Kalaallisut",
  • "kn": "Kannada",
  • "ks": "Kashmiri",
  • "ka": "Georgian",
  • "kr": "Kanuri",
  • "kk": "Kazakh",
  • "km": "Khmer",
  • "ki": "Kikuyu",
  • "rw": "Kinyarwanda",
  • "ky": "Kirghiz",
  • "kv": "Komi",
  • "kg": "Kongo",
  • "ko": "Korean",
  • "kj": "Kuanyama",
  • "ku": "Kurdish",
  • "lo": "Lao",
  • "la": "Latin",
  • "lv": "Latvian",
  • "li": "Limburgan",
  • "ln": "Lingala",
  • "lt": "Lithuanian",
  • "lb": "Luxembourgish",
  • "lu": "Luba-Katanga",
  • "lg": "Ganda",
  • "mh": "Marshallese",
  • "ml": "Malayalam",
  • "mr": "Marathi",
  • "mk": "Macedonian",
  • "mg": "Malagasy",
  • "mt": "Maltese",
  • "mn": "Mongolian",
  • "mi": "Maori",
  • "ms": "Malay (macrolanguage)",
  • "my": "Burmese",
  • "na": "Nauru",
  • "nv": "Navajo",
  • "nr": "South Ndebele",
  • "nd": "North Ndebele",
  • "ng": "Ndonga",
  • "ne": "Nepali (macrolanguage)",
  • "nl": "Dutch",
  • "nn": "Norwegian Nynorsk",
  • "nb": "Norwegian Bokmål",
  • "no": "Norwegian",
  • "ny": "Nyanja",
  • "oc": "Occitan",
  • "oj": "Ojibwa",
  • "or": "Oriya (macrolanguage)",
  • "om": "Oromo",
  • "os": "Ossetian",
  • "pa": "Panjabi",
  • "pks": "Pakistan Sign Language",
  • "pl": "Polish",
  • "pt": "Portuguese (Brazilian)",
  • "ps": "Pushto",
  • "qu": "Quechua",
  • "rm": "Romansh",
  • "ro": "Romanian",
  • "rsl": "Russian Sign Language",
  • "rn": "Rundi",
  • "ru": "Russian",
  • "sg": "Sango",
  • "sdl": "Saudi Arabian Sign Language",
  • "sfs": "South African Sign Language",
  • "si": "Sinhala",
  • "sk": "Slovak",
  • "sl": "Slovenian",
  • "se": "Northern Sami",
  • "sm": "Samoan",
  • "sn": "Shona",
  • "sd": "Sindhi",
  • "so": "Somali",
  • "st": "Southern Sotho",
  • "es": "Spanish (Spain)",
  • "sq": "Albanian",
  • "sc": "Sardinian",
  • "sr": "Serbian",
  • "ss": "Swati",
  • "su": "Sundanese",
  • "sw": "Swahili (macrolanguage)",
  • "sv": "Swedish",
  • "swl": "Swedish Sign Language",
  • "ty": "Tahitian",
  • "ta": "Tamil",
  • "tt": "Tatar",
  • "te": "Telugu",
  • "tg": "Tajik",
  • "tl": "Tagalog",
  • "th": "Thai",
  • "ti": "Tigrinya",
  • "tlh": "Klingon",
  • "to": "Tonga (Tonga Islands)",
  • "tn": "Tswana",
  • "ts": "Tsonga",
  • "tk": "Turkmen",
  • "tr": "Turkish",
  • "tw": "Twi",
  • "ug": "Uighur",
  • "uk": "Ukrainian",
  • "ur": "Urdu",
  • "uz": "Uzbek",
  • "ve": "Venda",
  • "vi": "Vietnamese",
  • "wa": "Walloon",
  • "wo": "Wolof",
  • "xh": "Xhosa",
  • "yi": "Yiddish",
  • "yo": "Yoruba",
  • "za": "Zhuang",
  • "zh": "Chinese",
  • "zu": "Zulu",
  • "zxx": "No linguistic content",
  • "tok": "Toki Pona",
  • "pt-PT": "Portuguese (Portugal)",
  • "es-419": "Spanish (Latin America)",
  • "zh-Hans": "Simplified Chinese",
  • "zh-Hant": "Traditional Chinese",
  • "ca-valencia": "Valencian",
  • "rcf": "Réunion Creole French",
  • "gcr": "Guianese Creole French"
}

List available video privacy policies

Responses

Response samples

Content type
application/json
{
  • "1": "Public",
  • "2": "Unlisted",
  • "3": "Private",
  • "4": "Internal",
  • "5": "Password protected"
}

Update a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

channelId
integer

New channel of the video. The channel must be owned by the same account as the previous one. Use the "change ownership" endpoints to give a video to a channel owned by another account on the local PeerTube instance.

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

name
string [ 3 .. 120 ] characters

Video name

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string or null <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
string

Whether or not we wait transcoding before publish the video

Responses

Get a video

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
  • "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
  • "isLive": true,
  • "liveSchedules": [
    ],
  • "createdAt": "2017-10-01T10:52:46.396Z",
  • "publishedAt": "2018-10-01T10:52:46.396Z",
  • "updatedAt": "2021-05-04T08:01:01.502Z",
  • "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
  • "category": {
    },
  • "licence": {
    },
  • "language": {
    },
  • "privacy": {
    },
  • "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
  • "duration": 1419,
  • "aspectRatio": 1.778,
  • "isLocal": true,
  • "name": "What is PeerTube?",
  • "thumbnailPath": "/lazy-static/thumbnails/a65bc12f-9383-462e-81ae-8207e8b434ee.jpg",
  • "previewPath": "/lazy-static/previews/a65bc12f-9383-462e-81ae-8207e8b434ee.jpg",
  • "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
  • "views": 1337,
  • "likes": 42,
  • "dislikes": 7,
  • "comments": 0,
  • "nsfw": true,
  • "nsfwFlags": 0,
  • "nsfwSummary": "string",
  • "waitTranscoding": true,
  • "state": {
    },
  • "scheduledUpdate": {
    },
  • "blacklisted": true,
  • "blacklistedReason": "string",
  • "account": {
    },
  • "channel": {
    },
  • "userHistory": {
    },
  • "viewers": 0,
  • "description": "\"**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network,\nbased on free/libre software!*\\r\\n\\r\\n**Animation Produced by:** [LILA](https://libreart.info) - [ZeMarmot Team](https://film.zemarmot.net)\\r\\n\n*Directed by* Aryeom\\r\\n*Assistant* Jehan\\r\\n**Licence**: [CC-By-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)\\r\\n\\r\\n\n**Sponsored by** [Framasoft](https://framasoft.org)\\r\\n\\r\\n**Music**: [Red Step Forward](http://play.dogmazic.net/song.php?song_id=52491) - CC-By Ken Bushima\\r\\n\\r\\n\n**Movie Clip**: [Caminades 3: Llamigos](http://www.caminandes.com/) CC-By Blender Institute\\r\\n\\r\\n**Video sources**: https://gitlab.gnome.org/Jehan/what-is-peertube/\"\n",
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "tags": [
    ],
  • "commentsPolicy": {
    },
  • "downloadEnabled": true,
  • "inputFileUpdatedAt": "2019-08-24T14:15:22Z",
  • "trackerUrls": [],
  • "files": [
    ],
  • "streamingPlaylists": [
    ]
}

Delete a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Get complete video description

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
"**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n"

Notify user is watching a video

Call this endpoint regularly (every 5-10 seconds for example) to notify the server the user is watching the video. After a while, PeerTube will increase video's viewers counter. If the user is authenticated, PeerTube will also store the current player time.

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
required
currentTime
required
integer <seconds>

timestamp within the video, in seconds

client
string

Client software used to watch the video. For example "Firefox", "PeerTube Approval Android", etc.

device
any
Enum: "console" "embedded" "mobile" "smarttv" "tablet" "wearable" "xr" "desktop"

Device used to watch the video. For example "desktop", "mobile", "smarttv", etc.

operatingSystem
string

Operating system used to watch the video. For example "Windows", "Ubuntu", etc.

sessionId
string

Optional param to represent the current viewer session. Used by the backend to properly count one view per session per video. PeerTube admin can configure the server to not trust this sessionId parameter but use the request IP address instead to identify a viewer.

viewEvent
string
Value: "seek"

Event since last viewing call:

  • seek - If the user seeked the video

Responses

Request samples

Content type
application/json
{
  • "currentTime": 5,
  • "viewEvent": "seek",
  • "sessionId": "string",
  • "client": "string",
  • "device": "console",
  • "operatingSystem": "string"
}

Upload a video

Uses a single request to upload a video.

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

videofile
required
string <binary>

Video file

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples 

## DEPENDENCIES: jq
USERNAME="<your_username>"
PASSWORD="<your_password>"
FILE_PATH="<your_file_path>"
CHANNEL_ID="<your_channel_id>"
NAME="<video_name>"
API="https://peertube2.cpy.re/api/v1"

## AUTH
client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret")
token=$(curl -s "$API/users/token" \
  --data client_id="$client_id" \
  --data client_secret="$client_secret" \
  --data grant_type=password \
  --data username="$USERNAME" \
  --data password="$PASSWORD" \
  | jq -r ".access_token")

## VIDEO UPLOAD
curl -s "$API/videos/upload" \
  -H "Authorization: Bearer $token" \
  --max-time 600 \
  --form videofile=@"$FILE_PATH" \
  --form channelId=$CHANNEL_ID \
  --form name="$NAME"

Response samples

Content type
application/json
{
  • "video": {
    }
}

Initialize the resumable upload of a video

Uses a resumable protocol to initialize the upload of a video

Authorizations:
OAuth2
header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
channelId
required
integer >= 1

Channel id that will contain this video

filename
required
string <filename>

Video filename including extension

name
required
string [ 3 .. 120 ] characters

Video name

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples

Content type
application/json
{
  • "name": "What is PeerTube?",
  • "channelId": 3,
  • "privacy": 1,
  • "category": 15,
  • "licence": 2,
  • "language": "en",
  • "description": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n",
  • "waitTranscoding": true,
  • "generateTranscription": true,
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "nsfw": true,
  • "nsfwSummary": null,
  • "nsfwFlags": 0,
  • "tags": [
    ],
  • "commentsPolicy": 1,
  • "downloadEnabled": true,
  • "originallyPublishedAt": "2019-08-24T14:15:22Z",
  • "scheduleUpdate": {
    },
  • "thumbnailfile": "string",
  • "previewfile": "string",
  • "videoPasswords": [
    ],
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable upload of a video

Uses a resumable protocol to continue, pause or resume the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Cancel the resumable upload of a video, deleting any data uploaded so far

Uses a resumable protocol to cancel the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Create a live

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer

Channel id that will contain this live video

name
required
string [ 3 .. 120 ] characters

Live video/replay name

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Live video/replay description

downloadEnabled
boolean

Enable or disable downloading for the replay of this live video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this live video/replay contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

permanentLive
boolean

User can stream multiple times in a permanent live

previewfile
string <binary>

Live video/replay preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)
support
string

A text tell the audience how to support the creator

tags
Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ]

Live video/replay tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Live video/replay thumbnail file

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Get information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "rtmpUrl": "string",
  • "rtmpsUrl": "string",
  • "streamKey": "string",
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

Update information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

permanentLive
boolean

User can stream multiple times in a permanent live

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)

Responses

Request samples

Content type
application/json
{
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

Get video source file metadata

Get metadata and download link of original video file

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "inputFilename": "string",
  • "fileDownloadUrl": "string",
  • "resolution": {
    },
  • "size": 0,
  • "fps": 0,
  • "width": 0,
  • "height": 0,
  • "createdAt": "2019-08-24T14:15:22Z"
}

Delete video source file

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Initialize the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to initialize the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
filename
string <filename>

Video filename including extension

Responses

Request samples

Content type
application/json
{
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

Request Body schema: application/octet-stream
string <binary>

Responses

Cancel the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to cancel the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

List storyboards of a video

PeerTube >= 6.0

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "storyboards": [
    ]
}

List videos of a video channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search videos

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

durationMax
integer

Get videos that have this maximum duration

durationMin
integer

Get videos that have this minimum duration

endDate
string <date-time>

Get videos that are published before this date

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
originallyPublishedEndDate
string <date-time>

Get videos that are originally published before this date

originallyPublishedStartDate
string <date-time>

Get videos that are originally published after this date

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

startDate
string <date-time>

Get videos that are published after this date

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Video Upload

Operations dealing with adding video or audio. PeerTube supports two upload modes, and three import modes.

Upload

  • legacy, where the video file is sent in a single request
  • resumable, where the video file is sent in chunks

You can upload videos more reliably by using the resumable variant. Its protocol lets you resume an upload operation after a network interruption or other transmission failure, saving time and bandwidth in the event of network failures.

Favor using resumable uploads in any of the following cases:

  • You are transferring large files
  • The likelihood of a network interruption is high
  • Uploads are originating from a device with a low-bandwidth or unstable Internet connection, such as a mobile device

Import

  • URL-based: where the URL points to any service supported by youtube-dl
  • magnet-based: where the URI resolves to a BitTorrent resource containing a single supported video file
  • torrent-based: where the metainfo file resolves to a BitTorrent resource containing a single supported video file

The import function is practical when the desired video/audio is available online. It makes PeerTube download it for you, saving you as much bandwidth and avoiding any instability or limitation your network might have.

Upload a video

Uses a single request to upload a video.

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

videofile
required
string <binary>

Video file

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples 

## DEPENDENCIES: jq
USERNAME="<your_username>"
PASSWORD="<your_password>"
FILE_PATH="<your_file_path>"
CHANNEL_ID="<your_channel_id>"
NAME="<video_name>"
API="https://peertube2.cpy.re/api/v1"

## AUTH
client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret")
token=$(curl -s "$API/users/token" \
  --data client_id="$client_id" \
  --data client_secret="$client_secret" \
  --data grant_type=password \
  --data username="$USERNAME" \
  --data password="$PASSWORD" \
  | jq -r ".access_token")

## VIDEO UPLOAD
curl -s "$API/videos/upload" \
  -H "Authorization: Bearer $token" \
  --max-time 600 \
  --form videofile=@"$FILE_PATH" \
  --form channelId=$CHANNEL_ID \
  --form name="$NAME"

Response samples

Content type
application/json
{
  • "video": {
    }
}

Initialize the resumable upload of a video

Uses a resumable protocol to initialize the upload of a video

Authorizations:
OAuth2
header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
channelId
required
integer >= 1

Channel id that will contain this video

filename
required
string <filename>

Video filename including extension

name
required
string [ 3 .. 120 ] characters

Video name

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples

Content type
application/json
{
  • "name": "What is PeerTube?",
  • "channelId": 3,
  • "privacy": 1,
  • "category": 15,
  • "licence": 2,
  • "language": "en",
  • "description": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n",
  • "waitTranscoding": true,
  • "generateTranscription": true,
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "nsfw": true,
  • "nsfwSummary": null,
  • "nsfwFlags": 0,
  • "tags": [
    ],
  • "commentsPolicy": 1,
  • "downloadEnabled": true,
  • "originallyPublishedAt": "2019-08-24T14:15:22Z",
  • "scheduleUpdate": {
    },
  • "thumbnailfile": "string",
  • "previewfile": "string",
  • "videoPasswords": [
    ],
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable upload of a video

Uses a resumable protocol to continue, pause or resume the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Cancel the resumable upload of a video, deleting any data uploaded so far

Uses a resumable protocol to cancel the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Import a video

Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)

Authorizations:
OAuth2
Request Body schema: multipart/form-data
One of
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

targetUrl
required
string <url>

remote URL where to find the import's source video

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Initialize the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to initialize the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
filename
string <filename>

Video filename including extension

Responses

Request samples

Content type
application/json
{
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

Request Body schema: application/octet-stream
string <binary>

Responses

Cancel the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to cancel the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Video Imports

Operations dealing with listing, adding and removing video imports.

Import a video

Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)

Authorizations:
OAuth2
Request Body schema: multipart/form-data
One of
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

targetUrl
required
string <url>

remote URL where to find the import's source video

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>

Video preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Cancel video import

Cancel a pending video import

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Retry video import

PeerTube >= 8.0 Retry a pending video import

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Delete video import

Delete ended video import

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Video Captions

Operations dealing with listing, adding and removing closed captions of a video.

List captions of a video

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Generate a video caption

PeerTube >= 6.2 This feature has to be enabled by the administrator

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
forceTranscription
boolean
Default: false

Responses

Request samples

Content type
application/json
{
  • "forceTranscription": false
}

Add or replace a video caption

Authorizations:
OAuth2
path Parameters
captionLanguage
required
string (VideoLanguageSet)
Example: en

The caption language

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
captionfile
string <binary>

The file to upload.

Responses

Delete a video caption

Authorizations:
OAuth2
path Parameters
captionLanguage
required
string (VideoLanguageSet)
Example: en

The caption language

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Video Chapters

Operations dealing with managing chapters of a video.

Get chapters of a video

PeerTube >= 6.0

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "chapters": {
    }
}

Replace video chapters

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
Array of objects

Responses

Request samples

Content type
application/json
{
  • "chapters": [
    ]
}

Video Channels

Operations dealing with the creation, modification and listing of videos within a channel.

List video channels

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Create a video channel

Authorizations:
OAuth2
Request Body schema: application/json
displayName
required
any

Channel display name

name
required
string [ 1 .. 50 ] characters /^[a-zA-Z0-9\\-_.:]+$/

username of the channel to create

description
any

Channel description

support
any

How to support/fund the channel

Responses

Request samples

Content type
application/json
{
  • "displayName": null,
  • "description": null,
  • "support": null,
  • "name": "framasoft_videos"
}

Response samples

Content type
application/json
{
  • "videoChannel": {
    }
}

Get a video channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "url": "string",
  • "name": "chocobozzz",
  • "avatars": [
    ],
  • "host": "example.com",
  • "hostRedundancyAllowed": true,
  • "followingCount": 0,
  • "followersCount": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "displayName": "Videos of Framasoft",
  • "description": "Videos made with <3 by Framasoft",
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "isLocal": true,
  • "banners": [
    ],
  • "ownerAccount": {
    }
}

Update a video channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
bulkVideosSupportUpdate
boolean

Update the support field for all videos of this channel

description
any

Channel description

displayName
any

Channel display name

support
any

How to support/fund the channel

Responses

Request samples

Content type
application/json
{
  • "displayName": null,
  • "description": null,
  • "support": null,
  • "bulkVideosSupportUpdate": true
}

Delete a video channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

List videos of a video channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List activities of a video channel

PeerTube >= 8.0

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List playlists of a channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Reorder channel playlists

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
insertAfterPosition
required
integer >= 0

New position for the block to reorder, to add the block before the first element

startPosition
required
integer >= 1

Start position of the element to reorder

reorderLength
integer >= 1

How many element from startPosition to reorder

Responses

Request samples

Content type
application/json
{
  • "startPosition": 1,
  • "insertAfterPosition": 0,
  • "reorderLength": 1
}

List followers of a video channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Value: "createdAt"

Sort followers by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Update channel avatar

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: multipart/form-data
avatarfile
string <binary>

The file to upload.

Responses

Response samples

Content type
application/json
{
  • "avatars": [
    ]
}

Delete channel avatar

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Update channel banner

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: multipart/form-data
bannerfile
string <binary>

The file to upload.

Responses

Response samples

Content type
application/json
{
  • "banners": [
    ]
}

Delete channel banner

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Import videos in channel

Import a remote channel/playlist videos into a channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
externalChannelUrl
required
string
videoChannelSyncId
integer

If part of a channel sync process, specify its id to assign video imports to this channel synchronization

Responses

Request samples

Content type
application/json
{}

List video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

withStats
boolean

include daily view statistics for the last 30 days and total views (only if authenticated as the account user)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List the synchronizations of video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search channels

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

handles
Array of strings

Find elements with these handles

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete channel information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

*List channel collaborators

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Invite a collaborator

PeerTube >= 8.0 Invite a local user to collaborate on the specified video channel.

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
required
accountHandle
string

Local user username to invite

Responses

Request samples

Content type
application/json
{
  • "accountHandle": "string"
}

Response samples

Content type
application/json
{
  • "collaborator": {
    }
}

Accept a collaboration invitation

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

collaboratorId
required
integer (id) >= 1
Example: 42

The collaborator id

Responses

Reject a collaboration invitation

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

collaboratorId
required
integer (id) >= 1
Example: 42

The collaborator id

Responses

Remove a channel collaborator

PeerTube >= 8.0 Only the channel owner or the collaborator themselves can remove a collaborator from a channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

collaboratorId
required
integer (id) >= 1
Example: 42

The collaborator id

Responses

Video Comments

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 its root comment thread.

List comments on user's videos

PeerTube >= 6.2

Authorizations:
OAuth2
query Parameters
string or Array of strings

PeerTube >= 6.2 filter on comments that contain one of these automatic tags

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

isHeldForReview
boolean

only display comments that are held for review

search
string

Plain text search, applied to various parts of the model depending on endpoint

searchAccount
string

Filter comments by searching on the account

searchVideo
string

Filter comments by searching on the video

videoChannelId
integer

Limit results on this specific video channel

videoId
integer

Limit results on this specific video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List threads of a video

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-createdAt" "-totalReplies"

Sort comments by criteria

start
integer >= 0

Offset used to paginate results

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "totalNotDeletedComments": 0,
  • "data": [
    ]
}

Create a thread

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
text
required
string <html> [ 1 .. 10000 ] characters

Text of the comment

Responses

Request samples

Content type
application/json
{
  • "text": "This video is wonderful!"
}

Response samples

Content type
application/json
{
  • "comment": {
    }
}

Get a thread

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

threadId
required
integer

The thread id (root comment id)

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "comment": {
    },
  • "children": [
    ]
}

List instance comments

Authorizations:
OAuth2
query Parameters
string or Array of strings

PeerTube >= 6.2 filter on comments that contain one of these automatic tags

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

onLocalVideo
boolean

Display only objects of local or remote videos

search
string

Plain text search, applied to various parts of the model depending on endpoint

searchAccount
string

Filter comments by searching on the account

searchVideo
string

Filter comments by searching on the video

videoChannelId
integer

Limit results on this specific video channel

videoId
integer

Limit results on this specific video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Reply to a thread of a video

Authorizations:
OAuth2
path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Request Body schema: application/json
text
required
string <html> [ 1 .. 10000 ] characters

Text of the comment

Responses

Request samples

Content type
application/json
{
  • "text": "This video is wonderful!"
}

Response samples

Content type
application/json
{
  • "comment": {
    }
}

Delete a comment or a reply

Authorizations:
OAuth2
path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Approve a comment

PeerTube >= 6.2 Approve a comment that requires a review

Authorizations:
OAuth2
path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Video Rates

Like/dislike a video.

Get rate of my user for a video

Authorizations:
OAuth2
path Parameters
videoId
required
integer >= 1
Example: 42

The video id

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "rating": "like"
}

Like/dislike a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Request Body schema: application/json
rating
required
string
Enum: "like" "dislike"

Responses

Request samples

Content type
application/json
{
  • "rating": "like"
}

Video Playlists

Operations dealing with playlists of videos. Playlists are bound to users and/or channels.

List playlists of a channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Reorder channel playlists

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
insertAfterPosition
required
integer >= 0

New position for the block to reorder, to add the block before the first element

startPosition
required
integer >= 1

Start position of the element to reorder

reorderLength
integer >= 1

How many element from startPosition to reorder

Responses

Request samples

Content type
application/json
{
  • "startPosition": 1,
  • "insertAfterPosition": 0,
  • "reorderLength": 1
}

List available playlist privacy policies

Responses

Response samples

Content type
application/json
{
  • "1": "Public",
  • "2": "Unlisted",
  • "3": "Private"
}

List video playlists

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Create a video playlist

If the video playlist is set as public, videoChannelId is mandatory.

Authorizations:
OAuth2
Request Body schema: multipart/form-data
displayName
required
string [ 1 .. 120 ] characters

Video playlist display name

description
string [ 3 .. 1000 ] characters

Video playlist description

privacy
integer (VideoPlaylistPrivacySet)
Enum: 1 2 3

Video playlist privacy policy (see /video-playlists/privacies)

thumbnailfile
string <binary>

Video playlist thumbnail file

videoChannelId
integer >= 1

Video channel in which the playlist will be published

Responses

Response samples

Content type
application/json
{
  • "videoPlaylist": {
    }
}

Get a video playlist

path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
  • "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "description": "string",
  • "displayName": "string",
  • "isLocal": true,
  • "videoLength": 0,
  • "thumbnailPath": "string",
  • "privacy": {
    },
  • "type": {
    },
  • "ownerAccount": {
    },
  • "videoChannel": {
    },
  • "videoChannelPosition": 1
}

Update a video playlist

If the video playlist is set as public, the playlist must have a assigned channel.

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: multipart/form-data
description
string

Video playlist description

displayName
string [ 1 .. 120 ] characters

Video playlist display name

privacy
integer (VideoPlaylistPrivacySet)
Enum: 1 2 3

Video playlist privacy policy (see /video-playlists/privacies)

thumbnailfile
string <binary>

Video playlist thumbnail file

videoChannelId
integer >= 1

Video channel in which the playlist will be published

Responses

Delete a video playlist

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Responses

List videos of a playlist

path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add a video in a playlist

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: application/json
required
string or integer

Video to add in the playlist

startTimestamp
integer <seconds>

Start the video at this specific timestamp

stopTimestamp
integer <seconds>

Stop the video at this specific timestamp

Responses

Request samples

Content type
application/json
{
  • "videoId": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
  • "startTimestamp": 0,
  • "stopTimestamp": 0
}

Response samples

Content type
application/json
{
  • "videoPlaylistElement": {
    }
}

Reorder playlist elements

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: application/json
insertAfterPosition
required
integer >= 0

New position for the block to reorder, to add the block before the first element

startPosition
required
integer >= 1

Start position of the element to reorder

reorderLength
integer >= 1

How many element from startPosition to reorder

Responses

Request samples

Content type
application/json
{
  • "startPosition": 1,
  • "insertAfterPosition": 0,
  • "reorderLength": 1
}

Update a playlist element

Authorizations:
OAuth2
path Parameters
playlistElementId
required
integer (id) >= 1
Example: 42

Playlist element id

playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: application/json
startTimestamp
integer <seconds>

Start the video at this specific timestamp

stopTimestamp
integer <seconds>

Stop the video at this specific timestamp

Responses

Request samples

Content type
application/json
{
  • "startTimestamp": 0,
  • "stopTimestamp": 0
}

Delete an element from a playlist

Authorizations:
OAuth2
path Parameters
playlistElementId
required
integer (id) >= 1
Example: 42

Playlist element id

playlistId
required
integer >= 1
Example: 42

Playlist id

Responses

Check video exists in my playlists

Authorizations:
OAuth2
query Parameters
videoIds
required
Array of integers[ items >= 1 ]
Example: videoIds=42

The video ids to check

Responses

Response samples

Content type
application/json
{
  • "videoId": [
    ]
}

List playlists of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
string or Array of strings

PeerTube >= 8.0 Filter on playlists that are published on a channel with one of these names

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search playlists

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete playlist information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Video Stats

Video statistics

Get overall stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
endDate
string <date-time>

Filter stats by end date

startDate
string <date-time>

Filter stats by start date

Responses

Response samples

Content type
application/json
{
  • "averageWatchTime": 0,
  • "totalWatchTime": 0,
  • "viewersPeak": 0,
  • "totalViewers": 0,
  • "viewersPeakDate": "2019-08-24T14:15:22Z",
  • "countries": [
    ],
  • "subdivisions": [
    ]
}

Get user agent stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
endDate
string <date-time>

Filter stats by end date

startDate
string <date-time>

Filter stats by start date

Responses

Response samples

Content type
application/json
{
  • "clients": [
    ],
  • "devices": [
    ],
  • "operatingSystem": [
    ]
}

Get retention stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get timeserie stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

metric
required
string
Enum: "viewers" "aggregateWatchTime"

The metric to get

query Parameters
endDate
string <date-time>

Filter stats by end date

startDate
string <date-time>

Filter stats by start date

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Video Ownership Change

List video ownership changes

Authorizations:
OAuth2

Responses

Accept ownership change request

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Refuse ownership change request

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Request ownership change

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
required
username
required
string

Responses

Request samples

Content type
application/json
{
  • "username": "string"
}

Video Mirroring

PeerTube instances can mirror videos from one another, and help distribute some videos.

For importing videos as your own, refer to video imports.

List videos being mirrored

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Value: "name"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

target
required
string
Enum: "my-videos" "remote-videos"

direction of the mirror

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Mirror a video

Authorizations:
OAuth2
Request Body schema: application/json
videoId
required
integer >= 1

object id for the video

Responses

Request samples

Content type
application/json
{
  • "videoId": 42
}

Delete a mirror done on a video

Authorizations:
OAuth2
path Parameters
redundancyId
required
string

id of an existing redundancy on a video

Responses

Video Files

Operations on video files

Delete video HLS files

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Delete video Web Video files

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Video Transcoding

Video transcoding related operations

Create a studio task

Create a task to edit a video (cut, add intro/outro etc)

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
required
Array
Any of
name
string
Value: "cut"
object

Responses

Create a transcoding job

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
transcodingType
required
string
Enum: "hls" "web-video"
forceTranscoding
boolean
Default: false

If the video is stuck in transcoding state, do it anyway

Responses

Request samples

Content type
application/json
{
  • "transcodingType": "hls",
  • "forceTranscoding": false
}

Live Videos

Create a live

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer

Channel id that will contain this live video

name
required
string [ 3 .. 120 ] characters

Live video/replay name

category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

description
string

Live video/replay description

downloadEnabled
boolean

Enable or disable downloading for the replay of this live video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this live video/replay contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

permanentLive
boolean

User can stream multiple times in a permanent live

previewfile
string <binary>

Live video/replay preview file

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)
support
string

A text tell the audience how to support the creator

tags
Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ]

Live video/replay tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Live video/replay thumbnail file

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Get information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "rtmpUrl": "string",
  • "rtmpsUrl": "string",
  • "streamKey": "string",
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

Update information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

permanentLive
boolean

User can stream multiple times in a permanent live

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)

Responses

Request samples

Content type
application/json
{
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

List live sessions

List all sessions created in a particular live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
sort
string
Example: sort=-createdAt

Sort column

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Get live session of a replay

If the video is a replay of a live, you can find the associated live session using this endpoint

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "startDate": "2019-08-24T14:15:22Z",
  • "endDate": "2019-08-24T14:15:22Z",
  • "error": 1,
  • "replayVideo": {
    }
}

Channels Sync

Operations dealing with synchronizing PeerTube user's channel with channels of other platforms

Import videos in channel

Import a remote channel/playlist videos into a channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
externalChannelUrl
required
string
videoChannelSyncId
integer

If part of a channel sync process, specify its id to assign video imports to this channel synchronization

Responses

Request samples

Content type
application/json
{}

Create a synchronization for a video channel

Authorizations:
OAuth2
Request Body schema: application/json
externalChannelUrl
string
videoChannelId
integer (id) >= 1

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "videoChannelSync": {
    }
}

Delete a video channel synchronization

Authorizations:
OAuth2
path Parameters
channelSyncId
required
integer >= 1
Example: 42

Channel Sync id

Responses

Triggers the channel synchronization job, fetching all the videos from the remote channel

Authorizations:
OAuth2
path Parameters
channelSyncId
required
integer >= 1
Example: 42

Channel Sync id

Responses

List the synchronizations of video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Video Passwords

Operation on video passwords

List video passwords

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Update video passwords

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
passwords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]

Responses

Request samples

Content type
application/json
{
  • "passwords": [
    ]
}

Add a video password

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
password
string

Responses

Request samples

Content type
application/json
{
  • "password": "string"
}

Delete a video password

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

videoPasswordId
required
integer (id) >= 1
Example: 42

The video password id

Responses

Search

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 instance) can be found via keywords and other criteria of the advanced search.

Administrators can also enable the use of a remote search system, indexing videos and channels not could be not federated by the instance.

Search videos

query Parameters
string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

durationMax
integer

Get videos that have this maximum duration

durationMin
integer

Get videos that have this minimum duration

endDate
string <date-time>

Get videos that are published before this date

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
originallyPublishedEndDate
string <date-time>

Get videos that are originally published before this date

originallyPublishedStartDate
string <date-time>

Get videos that are originally published after this date

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

startDate
string <date-time>

Get videos that are published after this date

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search channels

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

handles
Array of strings

Find elements with these handles

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete channel information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search playlists

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete playlist information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Abuses

Abuses deal with reports of local or remote videos/comments/accounts alike.

List my abuses

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

id
integer

only list the report with this id

sort
string
Enum: "-id" "-createdAt" "-state"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List abuses

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

filter
string
Enum: "video" "comment" "account"

only list account, comment or video reports

id
integer

only list the report with this id

predefinedReason
Array of strings (PredefinedAbuseReasons) <= 8 items
Items Enum: "violentOrAbusive" "hatefulOrAbusive" "spamOrMisleading" "privacy" "rights" "serverRules" "thumbnails" "captions"

predefined reason the listed reports should contain

search
string

plain search that will match with video titles, reporter names and more

searchReportee
string

only list reports of a specific reportee

searchReporter
string

only list reports of a specific reporter

searchVideo
string

only list reports of a specific video

searchVideoChannel
string

only list reports of a specific video channel

sort
string
Enum: "-id" "-createdAt" "-state"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

videoIs
string
Enum: "deleted" "blacklisted"

only list deleted or blocklisted videos

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Report an abuse

Authorizations:
OAuth2
Request Body schema: application/json
required
reason
required
string [ 2 .. 3000 ] characters

Reason why the user reports this video

object
object
predefinedReasons
Array of strings (PredefinedAbuseReasons) <= 8 items
Items Enum: "violentOrAbusive" "hatefulOrAbusive" "spamOrMisleading" "privacy" "rights" "serverRules" "thumbnails" "captions"

Reason categories that help triage reports

object

Responses

Request samples

Content type
application/json
{
  • "reason": "string",
  • "predefinedReasons": [
    ],
  • "video": {
    },
  • "comment": {
    },
  • "account": {
    }
}

Response samples

Content type
application/json
{
  • "abuse": {
    }
}

Update an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Request Body schema: application/json
moderationComment
string [ 2 .. 3000 ] characters

Update the report comment visible only to the moderation team

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

Responses

Request samples

Content type
application/json
{
  • "state": 1,
  • "moderationComment": "string"
}

Delete an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Responses

List messages of an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add message to an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Request Body schema: application/json
required
message
required
string [ 2 .. 3000 ] characters

Message to send

Responses

Request samples

Content type
application/json
{
  • "message": "string"
}

Delete an abuse message

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

abuseMessageId
required
integer >= 1
Example: 42

Abuse message id

Responses

Video Blocks

Operations dealing with blocking videos (removing them from view and preventing interactions).

Block a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Unblock a video by its id

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

List video blocks

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

plain search that will match with video titles, and more

sort
string
Enum: "-id" "name" "-duration" "-views" "-likes" "-dislikes" "-uuid" "-createdAt"

Sort blocklists by criteria

start
integer >= 0

Offset used to paginate results

type
integer
Enum: 1 2

list only blocks that match this type:

  • 1: manual block
  • 2: automatic block that needs review

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Account Blocks

Get block status of accounts/hosts

query Parameters
accounts
Array of strings
Example: accounts=goofy@example.com&accounts=donald@example.com

Check if these accounts are blocked

hosts
Array of strings
Example: hosts=example.com

Check if these hosts are blocked

Responses

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "hosts": {
    }
}

List account blocks

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Block an account

Authorizations:
OAuth2
Request Body schema: application/json
accountName
required
string

account to block, in the form username@domain

Responses

Request samples

Content type
application/json
{
  • "accountName": "chocobozzz@example.org"
}

Unblock an account by its handle

Authorizations:
OAuth2
path Parameters
accountName
required
string

account to unblock, in the form username@domain

Responses

Server Blocks

Get block status of accounts/hosts

query Parameters
accounts
Array of strings
Example: accounts=goofy@example.com&accounts=donald@example.com

Check if these accounts are blocked

hosts
Array of strings
Example: hosts=example.com

Check if these hosts are blocked

Responses

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "hosts": {
    }
}

List server blocks

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Block a server

Authorizations:
OAuth2
Request Body schema: application/json
host
required
string <hostname>

server domain to block

Responses

Request samples

Content type
application/json
{
  • "host": "example.com"
}

Unblock a server by its domain

Authorizations:
OAuth2
path Parameters
host
required
string <hostname>

server domain to unblock

Responses

Automatic Tags

Automatic tags set on objects (like comments or videos) by specific rules (external link, watched words, etc.)

Get account auto tag policies on comments

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to get auto tag policies

Responses

Response samples

Content type
application/json
{
  • "review": [
    ]
}

Update account auto tag policies on comments

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to update auto tag policies

Request Body schema: application/json
review
Array of strings

Auto tags that automatically set the comment in review state

Responses

Request samples

Content type
application/json
{
  • "review": [
    ]
}

Get account available auto tags

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to get auto tag policies

Responses

Response samples

Content type
application/json
{
  • "available": [
    ]
}

Get server available auto tags

PeerTube >= 6.2

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "available": [
    ]
}

Watched Words

Manage list of watched words to detect patterns on objects (like comments of videos)

List account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to list watched words

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string
Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Response samples

Content type
application/json
{
  • "watchedWordsList": {
    }
}

Update account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string
listId
required
string

list of watched words to update

Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Delete account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string
listId
required
string

list of watched words to delete

Responses

List server watched words

PeerTube >= 6.2

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add server watched words

PeerTube >= 6.2

Authorizations:
OAuth2
Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Response samples

Content type
application/json
{
  • "watchedWordsList": {
    }
}

Update server watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
listId
required
string

list of watched words to update

Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Delete server watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
listId
required
string

list of watched words to delete

Responses

Config

Each server exposes public information regarding supported videos and options.

Get instance public configuration

Responses

Response samples

Content type
application/json
{
  • "client": {
    },
  • "defaults": {
    },
  • "webadmin": {
    },
  • "instance": {},
  • "search": {
    },
  • "plugin": {
    },
  • "theme": {
    },
  • "email": {
    },
  • "contactForm": {
    },
  • "serverVersion": "8.0.1-nightly-2026-01-16",
  • "serverCommit": "",
  • "transcoding": {
    },
  • "live": {
    },
  • "videoStudio": {
    },
  • "videoFile": {
    },
  • "videoTranscription": {
    },
  • "import": {
    },
  • "export": {
    },
  • "autoBlacklist": {
    },
  • "avatar": {
    },
  • "banner": {
    },
  • "video": {
    },
  • "videoCaption": {
    },
  • "user": {
    },
  • "videoChannels": {
    },
  • "trending": {
    },
  • "tracker": {
    },
  • "followings": {},
  • "federation": {
    },
  • "broadcastMessage": {
    },
  • "homepage": {
    },
  • "openTelemetry": {
    },
  • "views": {
    },
  • "storyboards": {
    },
  • "webrtc": {
    },
  • "nsfwFlagsSettings": {
    },
  • "fieldsConstraints": {
    },
  • "signup": {
    }
}

Get instance "About" information

Responses

Response samples

Content type
application/json
{}

Get instance runtime configuration

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "instance": {
    },
  • "theme": {
    },
  • "services": {
    },
  • "cache": {
    },
  • "signup": {
    },
  • "admin": {
    },
  • "contactForm": {
    },
  • "user": {
    },
  • "transcoding": {
    },
  • "import": {
    },
  • "autoBlacklist": {
    },
  • "followers": {
    },
  • "storyboard": {
    },
  • "defaults": {
    }
}

Set instance runtime configuration

Authorizations:
OAuth2

Responses

Delete instance runtime configuration

Authorizations:
OAuth2

Responses

Update instance banner

Authorizations:
OAuth2
Request Body schema: multipart/form-data
bannerfile
string <binary>

The file to upload.

Responses

Delete instance banner

Authorizations:
OAuth2

Responses

Update instance avatar

Authorizations:
OAuth2
Request Body schema: multipart/form-data
avatarfile
string <binary>

The file to upload.

Responses

Delete instance avatar

Authorizations:
OAuth2

Responses

Update instance logo

Authorizations:
OAuth2
path Parameters
logoType
required
string
Enum: "favicon" "header-wide" "header-square" "opengraph"
Request Body schema: multipart/form-data
logofile
string <binary>

The file to upload.

Responses

Delete instance logo

Authorizations:
OAuth2
path Parameters
logoType
required
string
Enum: "favicon" "header-wide" "header-square" "opengraph"

Responses

Client Config

Configuration of the web client

Update client language

Set a cookie so that, the next time the client refreshes the HTML of the web interface, PeerTube will use the next language

Request Body schema: application/json
language
required
string

Language code to set

Responses

Request samples

Content type
application/json
{
  • "language": "en-US"
}

Homepage

Get and update the custom homepage

Get instance custom homepage

Responses

Response samples

Content type
application/json
{
  • "content": "string"
}

Set instance custom homepage

Authorizations:
OAuth2
Request Body schema: application/json
content
string

content of the homepage, that will be injected in the client

Responses

Request samples

Content type
application/json
{
  • "content": "string"
}

Instance Follows

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-server ActivityPub operations and propagates information across its social graph by posting activities to actors' inbox endpoints.

https://docs.joinpeertube.org/admin/following-instances#instances-follows

List instances following the server

query Parameters
actorType
string
Enum: "Person" "Application" "Group" "Service" "Organization"
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

state
string
Enum: "pending" "accepted"

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Remove or reject a follower to your server

Authorizations:
OAuth2
path Parameters
handle
required
string <email>

The remote actor handle to remove from your followers

Responses

Reject a pending follower to your server

Authorizations:
OAuth2
path Parameters
handle
required
string <email>

The remote actor handle to remove from your followers

Responses

Accept a pending follower to your server

Authorizations:
OAuth2
path Parameters
handle
required
string <email>

The remote actor handle to remove from your followers

Responses

List instances followed by the server

query Parameters
actorType
string
Enum: "Person" "Application" "Group" "Service" "Organization"
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

state
string
Enum: "pending" "accepted"

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Follow a list of actors (PeerTube instance, channel or account)

Authorizations:
OAuth2
Request Body schema: application/json
handles
Array of strings unique
hosts
Array of strings <hostname> unique [ items <hostname > ]

Responses

Request samples

Content type
application/json
{
  • "hosts": [
    ],
  • "handles": [
    ]
}

Unfollow an actor (PeerTube instance, channel or account)

Authorizations:
OAuth2
path Parameters
hostOrHandle
required
string

The hostOrHandle to unfollow

Responses

Instance Redundancy

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 selection of your choice. Note that you have a similar functionality to mirror individual videos, see video mirroring.

https://docs.joinpeertube.org/admin/following-instances#instances-redundancy

Update a server redundancy policy

Authorizations:
OAuth2
path Parameters
host
required
string <hostname>

server domain to mirror

Request Body schema: application/json
redundancyAllowed
required
boolean

allow mirroring of the host's local videos

Responses

Request samples

Content type
application/json
{
  • "redundancyAllowed": true
}

Plugins

Managing plugins installed from a local path or from NPM, or search for new ones.

https://docs.joinpeertube.org/api/plugins

List plugins

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

pluginType
integer
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

uninstalled
boolean

Responses

Response samples

Content type
application/json
{}

List available plugins

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

currentPeerTubeEngine
string
pluginType
integer
search
string
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{}

Install a plugin

Authorizations:
OAuth2
Request Body schema: application/json
One of
npmName
required
string

Responses

Request samples

Content type
application/json
{
  • "path": "string"
}

Update a plugin

Authorizations:
OAuth2
Request Body schema: application/json
One of
npmName
required
string

Responses

Request samples

Content type
application/json
{
  • "path": "string"
}

Uninstall a plugin

Authorizations:
OAuth2
Request Body schema: application/json
npmName
required
string

name of the plugin/theme in its package.json

Responses

Request samples

Content type
application/json
{
  • "npmName": "peertube-plugin-auth-ldap"
}

Get a plugin

Authorizations:
OAuth2
path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Responses

Response samples

Content type
application/json
{}

Set a plugin's settings

Authorizations:
OAuth2
path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "settings": { }
}

Get a plugin's public settings

path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Responses

Response samples

Content type
application/json
{ }

Get a plugin's registered settings

Authorizations:
OAuth2
path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Responses

Response samples

Content type
application/json
{ }

Stats

Statistics

Get instance stats

Get instance public statistics. This endpoint is cached.

Responses

Response samples

Content type
application/json
{
  • "totalUsers": 0,
  • "totalDailyActiveUsers": 0,
  • "totalWeeklyActiveUsers": 0,
  • "totalMonthlyActiveUsers": 0,
  • "totalModerators": 0,
  • "totalAdmins": 0,
  • "totalLocalVideos": 0,
  • "totalLocalVideoViews": 0,
  • "totalLocalVideoComments": 0,
  • "totalLocalVideoFilesSize": 0,
  • "totalVideos": 0,
  • "totalVideoComments": 0,
  • "totalLocalVideoChannels": 0,
  • "totalLocalDailyActiveVideoChannels": 0,
  • "totalLocalWeeklyActiveVideoChannels": 0,
  • "totalLocalMonthlyActiveVideoChannels": 0,
  • "totalLocalPlaylists": 0,
  • "totalInstanceFollowers": 0,
  • "totalInstanceFollowing": 0,
  • "videosRedundancy": [
    ],
  • "totalActivityPubMessagesProcessed": 0,
  • "totalActivityPubMessagesSuccesses": 0,
  • "totalActivityPubMessagesErrors": 0,
  • "activityPubMessagesProcessedPerSecond": 0,
  • "totalActivityPubMessagesWaiting": 0,
  • "averageRegistrationRequestResponseTimeMs": 0,
  • "totalRegistrationRequestsProcessed": 0,
  • "totalRegistrationRequests": 0,
  • "averageAbuseResponseTimeMs": 0,
  • "totalAbusesProcessed": 0,
  • "totalAbuses": 0
}

Create playback metrics

These metrics are exposed by OpenTelemetry metrics exporter if enabled.

Request Body schema: application/json
downloadedBytesHTTP
required
number

How many bytes were downloaded with HTTP since the last metric creation

downloadedBytesP2P
required
number

How many bytes were downloaded with P2P since the last metric creation

errors
required
number

How many errors occurred since the last metric creation

p2pEnabled
required
boolean
playerMode
required
string
Enum: "p2p-media-loader" "web-video"
resolutionChanges
required
number

How many resolution changes occurred since the last metric creation

uploadedBytesP2P
required
number

How many bytes were uploaded with P2P since the last metric creation

required
id (integer) or UUIDv4 (string) or shortUUID (string)
bufferStalled
number

How many times buffer has been stalled since the last metric creation

fps
number

Current player video fps

p2pPeers
number

P2P peers connected (doesn't include WebSeed peers)

resolution
number

Current player video resolution

Responses

Request samples

Content type
application/json
{
  • "playerMode": "p2p-media-loader",
  • "resolution": 0,
  • "fps": 0,
  • "p2pEnabled": true,
  • "p2pPeers": 0,
  • "resolutionChanges": 0,
  • "bufferStalled": 0,
  • "errors": 0,
  • "downloadedBytesP2P": 0,
  • "downloadedBytesHTTP": 0,
  • "uploadedBytesP2P": 0,
  • "videoId": 42
}

Logs

Send client log

Request Body schema: application/json
level
required
any
Enum: "error" "warn"
message
required
string
url
required
string

URL of the current user page

meta
string

Additional information regarding this log

stackTrace
string

Stack trace of the error if there is one

userAgent
string

User agent of the web browser that sends the message

Responses

Request samples

Content type
application/json
{
  • "message": "string",
  • "url": "string",
  • "level": "error",
  • "stackTrace": "string",
  • "userAgent": "string",
  • "meta": "string"
}

Get instance logs

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get instance audit logs

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
[
  • "string"
]

Job

Jobs are long-running tasks enqueued and processed by the instance itself. No additional worker registration is currently available.

Pause job queue

Authorizations:
OAuth2

Responses

Resume job queue

Authorizations:
OAuth2

Responses

List instance jobs

Authorizations:
OAuth2
path Parameters
state
required
string
Enum: "" "active" "completed" "failed" "waiting" "delayed"

The state of the job ('' for for no filter)

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

jobType
string
Enum: "activitypub-follow" "activitypub-http-broadcast" "activitypub-http-fetcher" "activitypub-http-unicast" "email" "video-transcoding" "video-file-import" "video-import" "videos-views-stats" "activitypub-refresher" "video-redundancy" "video-live-ending" "video-channel-import"

job type

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Runner Registration Token

Manage runner registration token

Generate registration token

Generate a new runner registration token

Authorizations:
OAuth2

Responses

Remove registration token

Remove a registration token. Runners that used this token for their registration are automatically removed.

Authorizations:
OAuth2
path Parameters
registrationTokenId
required
integer

Responses

List registration tokens

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Value: "createdAt"

Sort registration tokens by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Runner Jobs

Request a new job

API used by PeerTube runners

Request Body schema: application/json
runnerToken
required
string
jobTypes
Array of strings

Filter jobs depending on their types

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobTypes": [
    ]
}

Response samples

Content type
application/json
{
  • "availableJobs": [
    ]
}

Accept job

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string"
}

Response samples

Content type
application/json
{
  • "job": {
    }
}

Abort job

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
reason
required
string

Why the runner aborts this job

runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "reason": "string"
}

Update job

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
runnerToken
required
string
object
progress
integer

Update job progression percentage (optional)

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "progress": 0,
  • "payload": {
    }
}

Post job error

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
message
required
string

Why the runner failed to process this job

runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "message": "string"
}

Post job success

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
required
VOD web video transcoding (object) or VOD HLS transcoding (object) or VOD audio merge transcoding (object) or Live RTMP to HLS transcoding (object)
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "payload": {
    }
}

Cancel a job

Authorizations:
OAuth2
path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d

Responses

Delete a job

The endpoint will first cancel the job if needed, and then remove it from the database. Children jobs will also be removed

Authorizations:
OAuth2
path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d

Responses

List jobs

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Enum: "updatedAt" "createdAt" "priority" "state" "progress"

Sort runner jobs by criteria

start
integer >= 0

Offset used to paginate results

stateOneOf
Array of integers (RunnerJobState)
Items Enum: 1 2 3 4 5 6 7 8

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Runners

Register a new runner

API used by PeerTube runners

Request Body schema: application/json
name
required
string
registrationToken
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "registrationToken": "string",
  • "name": "string",
  • "description": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "runnerToken": "string"
}

Unregister a runner

API used by PeerTube runners

Request Body schema: application/json
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string"
}

Delete a runner

Authorizations:
OAuth2
path Parameters
runnerId
required
integer
Request Body schema: application/json
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string"
}

List runners

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Value: "createdAt"

Sort runners by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}