GET
https://spideriq.ai
/
api
/
v1
/
media
/
videos
/
{video_id}
/
status
Get Video Status
curl --request GET \
  --url https://spideriq.ai/api/v1/media/videos/{video_id}/status \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "video_id": "123",
  "uuid": "15aeeed0-4772-413f-a24b-be40d56326e6",
  "status": "transcoding",
  "embed_url": "https://videos.spideriq.ai/videos/embed/15aeeed0-4772-413f-a24b-be40d56326e6",
  "player_url": "https://videos.spideriq.ai/w/p/15aeeed0-4772-413f-a24b-be40d56326e6",
  "watch_url": "https://videos.spideriq.ai/w/15aeeed0-4772-413f-a24b-be40d56326e6",
  "file_url": null,
  "download_url": null,
  "duration": null,
  "views": 0
}
Get the processing status of an imported video. When processing is complete (status=ready), this endpoint returns direct .mp4 file URLs for automation workflows.

​
Path Parameters

​
video_id
string
required
PeerTube video ID (returned from the import endpoint)

​
Response

​
success
boolean
Whether the request succeeded
​
video_id
string
PeerTube video ID
​
uuid
string
PeerTube video UUID
​
status
string
Video processing status:
  • importing - Video is being downloaded from source
  • transcoding - Video is being transcoded
  • ready - Video is ready for playback
  • error - Processing failed
​
embed_url
string
URL for embedding the video in an iframe
​
player_url
string
Direct player URL
​
watch_url
string
URL to watch the video on PeerTube
​
file_url
string
Direct .mp4 file URL (only available when status=ready). Use this for automation workflows (N8N, Xano, etc.)
​
download_url
string
Download URL for the video file (only available when status=ready)
​
duration
integer
Video duration in seconds
​
views
integer
View count

​
Example

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

{
  "success": true,
  "video_id": "123",
  "uuid": "15aeeed0-4772-413f-a24b-be40d56326e6",
  "status": "transcoding",
  "embed_url": "https://videos.spideriq.ai/videos/embed/15aeeed0-4772-413f-a24b-be40d56326e6",
  "player_url": "https://videos.spideriq.ai/w/p/15aeeed0-4772-413f-a24b-be40d56326e6",
  "watch_url": "https://videos.spideriq.ai/w/15aeeed0-4772-413f-a24b-be40d56326e6",
  "file_url": null,
  "download_url": null,
  "duration": null,
  "views": 0
}
Automation Tip: Poll this endpoint periodically after importing a video. When status becomes ready, use the file_url to download or process the video file directly in your automation workflows.
Video processing time varies based on source video size and quality. Short videos typically complete within 1-2 minutes, while longer videos may take 5-10 minutes.