Skip to content
Pocat Documentation

API Overview

API Overview

Section titled “API Overview”

Pocat provides a RESTful API for YouTube video downloading and processing.

Base URL

Section titled “Base URL”

Live API: https://nonimitating-corie-extemporary.ngrok-free.dev

Core Endpoints

Section titled “Core Endpoints”

Create Project & Download Video

Section titled “Create Project & Download Video”
POST /v2/projects

Download a YouTube video with specified quality and downloader.

Parameters:

  • title (required): Project name
  • youtubeUrl (required): YouTube video URL
  • userId (required): User ID
  • quality (optional): Video quality (144p-4K, default: 720p)
  • downloader (optional): Download method (auto, yt-dlp, ytdl-core, puppeteer)

Access Downloaded Videos

Section titled “Access Downloaded Videos”
GET /storage/downloads/{filename}

Stream or download processed video files.

Response Format

Section titled “Response Format”

All API responses follow this structure:

{
  "success": boolean,
  "message": "string",
  "data": object
}

Rate Limits

Section titled “Rate Limits”
  • Requests: 100 per minute per IP
  • Downloads: 10 concurrent per user
  • File Size: Up to 2GB per video

Next Steps

Section titled “Next Steps”