README.md

---
title: Unified API
emoji: 🧠
colorFrom: blue
colorTo: indigo
sdk: docker
pinned: false
---

# PopCorn Unified API

Single API space for the PopCorn Mini App — combines all features:

- **Archive** — orchestrate archiver spaces, track progress, check duplicates, stats
- **Stream** — per-account proxied streaming with account-specific datasets
- **Movies / Series** — TMDB-powered browse, search, genres, trending
- **Auth** — Telegram Mini App login
- **User** — profiles, watch history, lists
- **Social** — friends, chat, watch parties
- **Store** — products, assets, purchases (stars/kernels)
- **Comments** — ratings, reviews, likes

## Architecture

```
upload-bot → /api/v1/archive/file → api → user[N]/archiver/receive → git push → HF dataset
                                          ↓
                                   /api/v1/archive/progress/update ← archiver reports
                                          ↓
                                   frontend polls /api/v1/archive/progress

frontend → /api/v1/stream/movie/{id} → api → user[N]/proxy/stream/{dataset}|{file}
```

## Accounts

| Key    | Name      | Dataset                           | Proxy                                | Archiver                              |
|--------|-----------|-----------------------------------|--------------------------------------|---------------------------------------|
| user1  | Mshary    | multimedia-cryptography-benchmarks/archive | ...-benchmarks-proxy.hf.space | ...-benchmarks-archiver.hf.space |
| user2  | Abdullah  | rayig/archive                     | rayig-proxy.hf.space                 | rayig-archiver.hf.space               |
| user3  | Abdulaziz | ToolKit-backend/archive           | toolkit-backend-proxy.hf.space       | toolkit-backend-archiver.hf.space     |
| user4  | Tariq     | Dgntsn.../archive                 | ...-proxy.hf.space                   | ...-archiver.hf.space                 |