> ## Documentation Index
> Fetch the complete documentation index at: https://help.decodo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parameters

> All Video downloader request parameters: video ID, storage URL, media type, quality and clip times, plus batch requests.

| Parameter | Type | Required | Description | Default | Example |
| - | - | - | - | - | - |
| `target` | string | ✅ | Always `youtube_video`. | | `youtube_video` |
| `query` | string | ✅ | YouTube video ID. In a batch request, an array of IDs. | | `dFu9aKJoqGg` |
| `upload_url` | string | ✅ | The URL of a folder in your S3-compatible storage, with your access key and secret. See [Storage setup](/docs/video-downloader-storage-setup). | | `https://<key>:<secret>@<storage-host>/<bucket>/<folder>` |
| `media` | string | | `video` (no sound), `audio`, or `audio_video` for both. | `audio_video` | `audio` |
| `quality` | string | | Video quality: `best`, `worst`, `480`, `720`, `1080`, `1440` or `2160`. | `720` | `1080` |
| `start_time` | string | | Start of the clip, in `hh:mm:ss`. Send it together with `end_time`. | | `00:01:30` |
| `end_time` | string | | End of the clip, in `hh:mm:ss`. Send it together with `start_time`. | | `00:02:00` |

## Limits

* Videos of up to 12 hours are supported.
* A single download can take up to 10 hours.
* Requests are asynchronous only. There's no real-time option.

## Batch requests

Queue several videos at once by sending `query` as an array to the batch endpoint. A batch can hold up to 100 videos, and all of them use the same `upload_url` and settings.

<CodeGroup>
  ```shellscript cURL theme={null}
  # replace 'TOKEN VALUE' with your Video downloader Basic auth token
  curl --request 'POST' \
          --url 'https://scraper-api.decodo.com/v2/task/batch' \
          --header 'Accept: application/json' \
          --header 'Authorization: Basic TOKEN VALUE' \
          --header 'Content-Type: application/json' \
          --data '
      {
        "target": "youtube_video",
        "query": [
          "PFRn5zKJTD8",
          "dFu9aKJoqGg"
        ],
        "upload_url": "https://access_key:access_secret@s3.us-west-2.amazonaws.com/your-bucket/video-folder"
      }
  '
  ```
</CodeGroup>

Each video gets its own task ID. Check each one as shown in [Status & results](/docs/video-downloader-status-results).

***

<Columns cols={2}>
  <Card title="Support" href="https://direct.lc.chat/12092754" cta="Let's chat!">
    Need help or just want to say hello? Our support is available 24/7. \
    You can also reach us anytime via email at [support@decodo.com](mailto:support@decodo.com).
  </Card>

  <Card title="Feedback" href="mailto:feedback@decodo.com" cta="Share feedback">
    Can't find what you're looking for? Request an article! \
    Have feedback? Share your thoughts on how we can improve.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.