🎬 Movies API

Free Movies, TV Series & Anime API Platform

Access thousands of movies, TV shows, and anime with our comprehensive API platform

🚀 Get Started • 📖 Documentation • 🔥 Features • 💡 Examples • 🤝 Contributing

---

🌟 Features

🎭 Multiple Sources Access content from 8+ popular platforms including VegaMovies, AllMoviesHub, KMmovies, and more	⚡ Fast & Reliable Optimized API endpoints with caching and rate limiting for consistent performance	🔐 Secure Access API key authentication with usage tracking and request limits
📱 Developer Friendly RESTful API with JSON responses, comprehensive docs, and code examples	🎯 Real-time Data Fresh content with real-time scraping and automatic updates	🆓 Free to Use Generous free tier with 1000+ requests per month

🎯 Supported Content Types

• 🎬 Movies - Latest releases, classics, regional cinema
• 📺 TV Series - Popular shows, seasons, episodes
• 🎌 Anime - Sub/dub content with episode tracking
• 🎭 Regional Content - Hindi, Tamil, Telugu, Malayalam movies
• 📱 Multiple Qualities - 480p to 4K content
• 🌍 Multi-language - Support for various languages and subtitles

🚀 Quick Start

1. Get Your API Key

Visit totu.me and sign up for a free account to get your API key.

2. Make Your First Request

curl -X GET "https://totu.me/api/posts" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

3. Start Building! 🎉

📖 API Documentation

Base URL

https://totu.me/api

Authentication

All requests require an API key in the header:

headers: {
  'x-api-key': 'YOUR_API_KEY',
  'Content-Type': 'application/json'
}

Available Endpoints

🎬 Movies API

Get Movies

GET /api/moviesdrive

Search Movies

GET /api/moviesdrive?search=avengers

Get Movie Details

GET /api/moviesdrive/episode?url=MOVIE_URL

Extract Download Links

GET /api/hubcloud?url=HUBCLOUD_URL

📺 Anime API

Get All Anime

GET /api/posts

Search Anime

GET /api/posts?search=naruto

Get Episode Details

GET /api/episodes/anime-id

Get Streaming Links

GET /api/video?url=EPISODE_URL

🎭 Multiple Platform APIs

• VegaMovies: /api/vegamovies
• AllMoviesHub: /api/allmovieshub
• KMmovies: /api/kmmovies
• DesireMovies: /api/desiremovies
• 10BitClub: /api/10bitclub
• VidSrc: /api/vidsrc

💡 Examples

JavaScript/Node.js

const response = await fetch('https://totu.me/api/posts?search=demon slayer', {
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data.posts);

Python

import requests

url = "https://totu.me/api/moviesdrive"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
data = response.json()
print(data["posts"])

cURL

curl -X GET "https://totu.me/api/vegamovies?search=spider-man" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

📊 Response Format

All endpoints return standardized JSON responses:

{
  "success": true,
  "count": 20,
  "posts": [
    {
      "id": "123",
      "title": "Movie Title (2024)",
      "imageUrl": "https://example.com/poster.jpg",
      "postUrl": "https://example.com/movie-page",
      "qualities": ["480p", "720p", "1080p"],
      "languages": ["Hindi", "English"],
      "releaseYear": "2024"
    }
  ],
  "remainingRequests": 995
}

🛠️ Tech Stack

• Framework: Next.js 14 with App Router
• Database: PostgreSQL with Drizzle ORM
• Authentication: Firebase Auth
• Styling: Tailwind CSS + shadcn/ui
• Web Scraping: Cheerio + Axios
• Deployment: Vercel
• Language: TypeScript

🎨 Features in Detail

🔍 Advanced Search

• Full-text search across multiple platforms
• Filter by quality, language, year
• Category-based browsing
• Real-time suggestions

📈 Analytics Dashboard

• Request usage tracking
• API key management
• Performance metrics
• Rate limit monitoring

🔐 Security Features

• API key authentication
• Rate limiting
• Request validation
• Error handling

🎯 Developer Tools

• Interactive API explorer
• Code generation
• Response examples
• Comprehensive documentation

🚦 Rate Limits

Plan	Requests/Month	Rate Limit
Free	1,000	100/hour
Pro	10,000	500/hour
Enterprise	Unlimited	Custom

🌐 Browser Support

• ✅ Chrome (Latest)
• ✅ Firefox (Latest)
• ✅ Safari (Latest)
• ✅ Edge (Latest)
• ✅ Mobile browsers

📝 Changelog

v2.0.0 (Latest)

• 🎉 Added VegaMovies API support
• 🔧 Improved error handling
• ⚡ Enhanced performance
• 📱 Better mobile responsiveness

v1.5.0

• 🎌 Added Anime API
• 🔐 Implemented API key system
• 📊 Added analytics dashboard

View Full Changelog

🙋‍♂️ Support

• 📧 Email: [email protected]
• 💬 Telegram: Join our community
• 🐛 Issues: GitHub Issues
• 📖 Docs: totu.me/docs

🌟 Show Your Support

If this project helps you, please consider:

• ⭐ Starring this repository
• 🐛 Reporting bugs
• 💡 Suggesting new features
• 🤝 Contributing to the code

---

Made with ❤️ by the ScreenScape Team

Website • Documentation • GitHub