List Videos

GET/api/v1/media/videos

List all videos in your dedicated PeerTube channel.

Response

successboolean

Whether the request succeeded

videosarray

Array of video objects

Video Object

idinteger

PeerTube video ID

titlestring

Video title

descriptionstring

Video description

durationinteger

Duration in seconds

viewsinteger

View count

watch_urlstring

URL to watch the video

embed_urlstring

URL for embedding

thumbnail_urlstring

Video thumbnail URL

privacyinteger

Privacy setting (1=public, 2=unlisted, 3=private)

statestring

Video state (published, importing, processing)

created_atstring

ISO 8601 creation timestamp

totalinteger

Total number of videos

Example

cURL

curl "https://spideriq.ai/api/v1/media/videos" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx"

Python

import requests

url = "https://spideriq.ai/api/v1/media/videos"
headers = {"Authorization": "Bearer cli_abc123:sk_xxx:secret_xxx"}

response = requests.get(url, headers=headers)
print(response.json())

Response Example

{
  "success": true,
  "videos": [
    {
      "id": 123,
      "title": "Product Demo",
      "description": "Our product demonstration video",
      "duration": 180,
      "views": 42,
      "watch_url": "https://videos.spideriq.ai/w/abc123xyz",
      "embed_url": "https://videos.spideriq.ai/videos/embed/abc123xyz",
      "thumbnail_url": "https://videos.spideriq.ai/static/thumbnails/abc123.jpg",
      "privacy": 2,
      "state": "published",
      "created_at": "2026-01-08T20:30:00Z"
    }
  ],
  "total": 1
}