POST
https://spideriq.ai
/
api
/
v1
/
media
/
videos
/
bulk-import
Bulk Import Videos
curl --request POST \
  --url https://spideriq.ai/api/v1/media/videos/bulk-import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videos": [
    {}
  ],
  "privacy": 123
}
'
{
  "success": true,
  "job_id": "bulk_1234567890",
  "total_videos": 3,
  "message": "Bulk import job started"
}
Import up to 500 videos in a single request. Videos are processed in the background with automatic proxy rotation and rate limiting to avoid detection from platforms like YouTube.

​
Request

​
videos
array
required
List of videos to import (max 500)Each video object contains:
  • url (string, required): Video URL to import
  • title (string, optional): Custom title (auto-detected if not provided)
​
privacy
integer
default:"2"
Privacy setting for all videos:
  • 1 = Public (visible to everyone)
  • 2 = Unlisted (accessible via link only)
  • 3 = Private (only you can view)

​
Response

​
success
boolean
Whether the bulk import job was created
​
job_id
string
Job ID for tracking progress
​
total_videos
integer
Number of videos queued for import
​
message
string
Status message

​
Example

curl -X POST "https://spideriq.ai/api/v1/media/videos/bulk-import" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {"url": "https://youtube.com/watch?v=video1", "title": "Product Demo 1"},
      {"url": "https://youtube.com/watch?v=video2", "title": "Product Demo 2"},
      {"url": "https://youtube.com/watch?v=video3"}
    ],
    "privacy": 2
  }'

{
  "success": true,
  "job_id": "bulk_1234567890",
  "total_videos": 3,
  "message": "Bulk import job started"
}

​
Tracking Progress

Use the returned job_id to check the status of your bulk import: 
curl "https://spideriq.ai/api/v1/media/videos/bulk-import/bulk_1234567890" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx"
See Bulk Import Status for details on tracking job progress.
Processing Time: Videos are processed with 30-90 second delays between downloads to avoid rate limiting. A batch of 100 YouTube videos may take 1-3 hours to complete.
YouTube Imports: YouTube videos are automatically routed through mobile proxies to bypass bot detection. This may increase processing time but ensures reliable imports.