Skip to content
Pocat Documentation

Quick Start

Quick Start Guide

Section titled “Quick Start Guide”

Get up and running with Pocat in just a few minutes.

Live API Endpoint

Section titled “Live API Endpoint”

Base URL: https://nonimitating-corie-extemporary.ngrok-free.dev

Basic Usage

Section titled “Basic Usage”

Download any YouTube video with a simple POST request:

Terminal window
curl -X POST https://nonimitating-corie-extemporary.ngrok-free.dev/v2/projects \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My Video Project",
    "youtubeUrl": "https://www.youtube.com/watch?v=VIDEO_ID",
    "userId": 1,
    "downloader": "yt-dlp"
  }'

Response

Section titled “Response”
{
  "success": true,
  "message": "Project created, video download started using yt-dlp",
  "data": {
    "projectId": 11,
    "title": "My Video Project",
    "status": "downloading",
    "downloader": "yt-dlp"
  }
}

Access Downloaded Video

Section titled “Access Downloaded Video”

Once downloaded, access your video at:

https://nonimitating-corie-extemporary.ngrok-free.dev/storage/downloads/project_11_full.mp4

Next Steps

Section titled “Next Steps”