Video downloader

​

youtube_video

# update 'TOKEN VALUE' with your authorization token
curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/task' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic TOKEN VALUE' \
        --header 'Content-Type: application/json' \
        --data '
    {
      "target": "youtube_video",
      "query": "PFRn5zKJTD8",
      "upload_url": "https://storage_username:[email protected]/video-folder"
    }
'

​

Delivery to S3

1. Create a new S3 bucket with default setup and permissions.
2. Create a new IAM user.
3. Attach the PutObject permission for your bucket on the IAM user:
   1. Add an inline policy:
      
   2. Under Service, select S3.
   3. Under Actions:
      1. The following permissions need to be added to the bucket:
         • GetBucketLocation
      2. The following permissions need to be added to the folder of the bucket:
         • PutObject
         • PutObjectAcl
   4. Under Resources, select Specific, click on Add ARN, add your bucket name and your video folder name:
      
   5. Your final policy statement should look like this:
      {
      	"Version": "2012-10-17",
      	"Statement": [
      		{
      			"Sid": "Statement01",
      			"Effect": "Allow",
      			"Action": "s3:GetBucketLocation"
      			"Resource": "arn:aws:s3:::your-bucket"
      		},
      		{
      			"Sid": "Statement02",
      			"Effect": "Allow",
      			"Action": [
      				"s3:PutObject",
      				"s3:PutObjectAcl"
      			],
      			"Resource": "arn:aws:s3:::your-bucket/*"
      		}
      	]
      }
      
4. Generate an access key and secret for that user.
   1. When asked for a use case, select Other.
   The access key sent to Scraper API cannot include any non URI-escaped characters that may conflict with the upload_url parameter, such as / or @. If your key generated by AWS includes such characters, please regenerate your key.
5. Call Scraper API with the following sample parameters:

{
    "target": "youtube_video",
    "query": "PFRn5zKJTD8",
    "upload_url": "https://access_key:[email protected]/video-folder"
}

• access_key and access_secret are generated from step 4.
• us-west-2 is used as a sample region, your AWS region may be different.
• A /video-folder must be provided.

​

S3-compatible Providers

• MinIO
• Wasabi
• DigitalOcean Spaces
• Backblaze B2
• Scaleway Object Storage
• Linode Object Storage
• IBM Cloud Object Storage
• Oracle Cloud Object Storage
• Hetzner Cloud Storage

​

Sample Request

# update 'TOKEN VALUE' with your authorization token
curl --request 'POST' \
        --url 'https://scraper-api.decodo.com/v2/task' \
        --header 'Accept: application/json' \
        --header 'Authorization: Basic Authentication Token' \
        --header 'Content-Type: application/json' \
        --data '
    {
      "target": "youtube_video",
      "query": "PFRn5zKJTD8",
      "upload_url": "https://storage_username:[email protected]/video-folder"
    }
'

{
    "target": "youtube_video",
    "query": "PFRn5zKJTD8",
    "page_from": 1,
    "limit": 10,
    "geo": null,
    "device_type": "desktop",
    "headless": null,
    "parse": false,
    "locale": null,
    "domain": "com",
    "output_schema": null,
    "created_at": "2025-07-01 11:09:53",
    "id": "7345770621134969857",
    "status": "pending",
    "content_encoding": "utf-8",
    "updated_at": "2025-07-01 11:09:53",
    "force_headers": false,
    "force_cookies": false,
    "headers_cookies_policy": false,
    "media": "audio_video",
    "quality": "720"
}

​

Accessing geo-restricted videos

​

Monitoring progress

• HTTP status code 204 indicates that the download is still processing.
• HTTP status code 200 indicates that the download has finished and an attempt to upload to your storage direction has been made. If video was not uploaded status_code in the response will provide reasoning, there requests are billed for the traffic that was used attempting to fetch a video: