Pinchana

A modular media extraction API with a privacy-conscious browser client.

Pinchana has two public product surfaces documented here:

Pinchana API is the FastAPI gateway and modular extraction stack. It routes supported URLs to independent scraper services, normalizes results into the versioned /v1/scrape contract, protects cached media, and exposes isolated browser-session and private-download flows.
Pinchana Web is the official Next.js browser client. Browser code talks only to same-origin /api/... routes; its server-side backend-for-frontend communicates with Pinchana API, stores signed browser sessions in HttpOnly cookies, and keeps machine credentials out of the browser.

The normal scrape pipeline currently covers TikTok, Instagram, YouTube Shorts, SoundCloud, YouTube Music, Spotify, Deezer, Threads, and Twitter/X. General YouTube and youtu.be downloads are handled separately by the optional browser-only DLP protocol v2 stack when an API deployment advertises that capability.

Public projects

Pinchana API — MIT licensed orchestration repository with public scraper/DLP submodules.
Pinchana Web — AGPL-3.0-only official browser interface.
Pinchana Docs — this documentation site.

Public origins

Web: https://pinchana.cc
API: https://api.pinchana.cc
Docs: https://docs.pinchana.cc

Self-hosters can run their own API and Web deployments. The official Web client accepts custom API origins only when the exact HTTPS origin has a valid, unexpired project-issued Ed25519 instance certificate.

Start with Using Pinchana Web if you just want to download media, or API quickstart if you are integrating or self-hosting the gateway.