Import Video

POST/api/v1/media/videos/import

Import a video from a URL to your dedicated PeerTube channel. Supports YouTube, Vimeo, direct video URLs, and other supported platforms.

Request

urlstringrequired

Video URL to import (YouTube, Vimeo, direct link, etc.)

titlestring

Video title (defaults to extracted title from source)

descriptionstring

Video description

privacyintegerdefault: 2

Privacy setting:

• 1 = Public (visible to everyone)
• 2 = Unlisted (accessible via link only)
• 3 = Private (only you can view)

Response

successboolean

Whether the import was initiated

video_idinteger

PeerTube video ID

titlestring

Video title

watch_urlstring

URL to watch the video

embed_urlstring

URL for embedding the video

channel_namestring

Your PeerTube channel name

Example

cURL

curl -X POST "https://spideriq.ai/api/v1/media/videos/import" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Product Demo",
    "description": "Our product demonstration video",
    "privacy": 2
  }'

Python

import requests

url = "https://spideriq.ai/api/v1/media/videos/import"
headers = {
    "Authorization": "Bearer cli_abc123:sk_xxx:secret_xxx",
    "Content-Type": "application/json"
}
data = {
    "url": "https://youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Product Demo",
    "description": "Our product demonstration video",
    "privacy": 2
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Response Example

{
  "success": true,
  "video_id": 123,
  "title": "Product Demo",
  "description": "Our product demonstration video",
  "watch_url": "https://videos.spideriq.ai/w/abc123xyz",
  "embed_url": "https://videos.spideriq.ai/videos/embed/abc123xyz",
  "channel_name": "client_cli_abc123",
  "privacy": 2,
  "state": "importing"
}

note

Video imports may take several minutes depending on the source video size. The video will be in "importing" state until processing completes.