API Reference

Public media extraction API with consistent response shape and environment-aware extractor capability.

Quick Start

# cURL
curl -X POST https://fetchtiumv2.up.railway.app/api/v1/extract \
  -H "Content-Type: application/json" \
  -d '{"url":"https://youtube.com/watch?v=dQw4w9WgXcQ"}'

# PowerShell
$body = @{ url = "https://youtube.com/watch?v=dQw4w9WgXcQ" } | ConvertTo-Json
Invoke-RestMethod -Uri "https://fetchtiumv2.up.railway.app/api/v1/extract" -Method POST -Body $body -ContentType "application/json"

Access Model

All endpoints are public. API key is not required.

- Hardcoded limit: /api/v1/extract = 10 requests/minute per IP
- Streaming/proxy routes use higher limits for stable playback

Deployment Profile

Active profile: vercel

- `vercel` profile: native extractors only
- `full` profile: native + Python wrappers
- Unsupported-by-deployment requests return PLATFORM_UNAVAILABLE_ON_DEPLOYMENT

Supported Platforms (Live)

Native (0)

Full wrapper platform coverage is available on Railway/Docker deployment profile.

Endpoints

POST/api/v1/extract

Extract media metadata from a supported URL.

Request Body

{
  "url": "https://...",
  "cookie": "..." // optional
}

Error Response

{
  "success": false,
  "error": {
    "code": "PLATFORM_UNAVAILABLE_ON_DEPLOYMENT",
    "message": "This platform is available on Railway/Docker deployment."
  },
  "meta": {
    "responseTime": 4,
    "accessMode": "public",
    "publicContent": true
  }
}

GET/api/v1/stream

Proxy stream for media playback

GET/api/v1/download

Download with filename header

GET/api/v1/merge

Merge separate video and audio streams

GET/api/v1/thumbnail

Proxy thumbnail images

GET/api/v1/status

Server status and supported platform list

GET/api/health

Health check endpoint

Error Codes

Code	Description
INVALID_URL	URL format is invalid
UNSUPPORTED_PLATFORM	Platform is not supported
PLATFORM_UNAVAILABLE_ON_DEPLOYMENT	Platform exists but is disabled on current deployment profile
RATE_LIMITED	Too many requests in current window
EXTRACTION_FAILED	Extraction process failed