# Youtube Video Download

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/youtube/video/download` |
| **Base URL** | `https://api.huntapi.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/youtube-video-download |

## Description

Download public YouTube videos from any standard URL and get a direct CDN link to the processed media file, no extractor maintenance required.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.huntapi.com/register

## Example Request

```bash
curl --location --request GET 'https://api.huntapi.com/v2/youtube/video/download' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Download a public video

```json
{
  "result": "https://s3.huntapi.com/videos/video_id.mp4"
}
```

## Documentation

> **Disabled on Piloterr:** This endpoint is no longer available on Piloterr. You must use HuntAPI instead:

```
GET https://api.huntapi.com/v1/video/download?query=<video_url>
```

See HuntAPI documentation for job polling (`/v1/jobs/{id}`), download options, and webhooks.

## Overview
The YouTube Video Download API processes public YouTube links and returns a direct CDN URL to the downloaded media file. Built for archiving, internal workflows, and media pipelines without running yt-dlp or maintaining download infrastructure.

## Quickstart
```
GET https://api.piloterr.com/v2/youtube/video/download?query=https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

Or via POST:
```
POST https://api.piloterr.com/v2/youtube/video/download
Content-Type: application/json

{"query": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Public YouTube video URL (`watch`, `youtu.be`, or `embed`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `result` | string | CDN URL of the processed video file hosted on HuntAPI (s3.huntapi.com) |

## Notes
- Only publicly accessible videos are supported.
- Requires authentication via the `x-api-key` header.
- Successful downloads are billed per API call.

## Main use cases
- Archive public YouTube content for compliance or internal libraries
- Build media download tools without maintaining extractors
- Feed automation workflows (n8n, Zapier) with direct CDN download links
- Enrich content monitoring pipelines with downloadable video assets