Cinetaro API
TMDB-powered JSON API with Redis Caching & Proxy Fallback
v2.0.0
Redis Cache
Proxy Fallback
System Status
Checking connectivity...
Cache Status
Checking cache...
Endpoints
GET
/api/home
Homepage (all sections)
GET
/api/details/:id?type=movie|tv
Content details
GET
/api/watch/:id?type=movie|tv&s=1
Watch page + episodes
GET
/api/search?keyword=xxx&page=1
Search multi
GET
/api/filter?type=movie|tv&page=1&genre=28&year=2024
Discover / Filter
GET
/api/azlist?letter=A&page=1
A-Z listing
GET
/api/proxy
Proxy health check
GET
/api/cache
Cache status
Click an endpoint above to test
Features
- Redis caching with in-memory fallback
- Direct fetch first, Webshare proxy only as fallback
- Automatic proxy activation when IP is blocked (403/429)
- Retry with exponential backoff on errors
- 30-minute default cache TTL for TMDB responses
- Graceful degradation when Redis is unavailable
Proxy Config
Provider: Webshare Rotating Proxy
Host: p.webshare.io:80
Mode: Fallback only — proxy is used when direct IP is blocked or rate-limited (403/429)
Retry: 3 attempts with exponential backoff + 1 last-resort proxy attempt
Environment Variables
TMDB_API_KEY = your TMDB API key
REDIS_URL = Redis connection URL (e.g. redis://user:pass@host:port/db)
PROXY_USER = Webshare proxy username (default: qijlkvsz-rotate)
PROXY_PASS = Webshare proxy password
PORT = Server port (default: 3000)
Response Structure (home)
{
"success": true,
"results": {
"spotlights": [...],
"trending": [...],
"topAiring": [...],
"mostPopular": [...],
"mostFavorite": [...],
"latestCompleted": [...],
"latestReleases": [...],
"popularMovies": [...],
"popularTVSeries": [...],
"top10": { "day": [...], "week": [...], "month": [...] },
"upcoming": [...]
}
}