Status — Work in progress

Our API documentation is under active development. The first public release will include:

  • Authentication (API keys & OAuth options)
  • /v1/extract endpoint — extract formats for a given URL
  • Batch & playlist extraction endpoints
  • Webhooks & job status callbacks
  • Rate limits, pricing and SLAs for enterprise
  • SDK examples (curl, Node.js, Python)
Sample endpoints (placeholder)
These are example endpoints; request/response formats will be documented in full when the docs are live.
POST https://shadowsaver.site/api/v1/extract
Content-Type: application/json
Authorization: Bearer <API_KEY>

{
  "url": "https://www.youtube.com/watch?v=EXAMPLE",
  "options": { "audio_only": false, "preferred_quality": "720p" }
}
Sample response (example)
{
  "success": true,
  "id": "job_abc123",
  "title": "Example Video Title",
  "formats": [
    { "url":"https://cdn.example/...mp4", "quality":"720p", "container":"mp4", "filesize":"12MB" },
    { "url":"https://cdn.example/...mp3", "quality":"128k", "container":"mp3", "filesize":"3MB" }
  ]
}
Quick start — curl
curl -X POST "https://shadowsaver.site/api/v1/extract" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url":"https://www.youtube.com/watch?v=EXAMPLE" }'
Rate limits & pricing (preview)

Public web usage will remain free. API plans will include:

  • Free tier — limited requests per minute
  • Pro tier — higher limits and priority
  • Enterprise — custom SLA, dedicated nodes & SLA

Note: Final limits and pricing will be published alongside the docs. If you need early access or a custom plan, contact: api@shadowsaver.site

Security & Best Practices
  1. Keep your API keys secret; rotate periodically.
  2. Respect platform copyright and terms of service.
  3. Use webhooks to receive async job updates for long-running extractions.
  4. Cache results on your side responsibly to minimize repeated extraction requests.