Skip to content

rudiansyah1998/cutad-api-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

cutad-api-docs

Free streaming API — akses ribuan drama, anime, dan film gratis. Anime, Donghua, DramaBox, Melolo, MovieBox & more.

CUTAD API — Free Streaming API 🎬

Akses ribuan drama, anime, donghua, dan film gratis lewat REST API. Gratis, tanpa biaya, tanpa batas waktu.

Website: cutad.web.id Dokumentasi: cutad.web.id/docs


🚀 Mulai dalam 30 Detik

1. Dapatkan API Key (Gratis)

curl -X POST https://www.cutad.web.id/public/api/v1/key/generate \
  -H "Content-Type: application/json" \
  -d '{"name": "Nama Kamu", "email": "kamu@email.com"}'

Response:

{
  "message": "API key generated successfully",
  "apiKey": "cutad_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "rateLimit": "30 requests/minute"
}

2. Gunakan API Key

Kirim API key lewat header atau query parameter:

# Header (recommended)
curl https://www.cutad.web.id/public/api/v1/anime/rank \
  -H "X-API-Key: cutad_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Query parameter
curl "https://www.cutad.web.id/public/api/v1/anime/rank?api_key=cutad_xxx"

📋 Provider Tersedia

Provider Deskripsi ID
🎮 Anime Anime subtitle Indonesia anime
🐉 Donghua Animasi China donghua
📱 DramaBox Drama pendek dramabox
🎬 Melolo Drama & film pendek melolo
🎥 Film1 Film Indonesia film1
🎞️ SFilmIndo Streaming film Indonesia sfilmindo
🎬 Movie Film berbagai genre movie
😉 FreeReels Drama pendek gratis freereels
🇰🇷 Drama Korea K-Drama dramakorea
🎬 MovieBox Film & series moviebox

📡 Endpoint

Daftar Provider

GET /public/api/v1/providers

Tidak perlu API key. Mengembalikan daftar semua provider + endpoint yang tersedia.

Rank / Home

GET /public/api/v1/{provider}/rank

Contoh:

# Anime terpopuler
curl https://www.cutad.web.id/public/api/v1/anime/rank \
  -H "X-API-Key: YOUR_KEY"

# DramaBox terpopuler
curl https://www.cutad.web.id/public/api/v1/dramabox/rank \
  -H "X-API-Key: YOUR_KEY"

Response:

{
  "data": {
    "sections": [
      {
        "name": "Popular",
        "items": [
          {
            "id": "abc123",
            "title": "Judul Anime",
            "cover": "https://...",
            "episode": 12,
            "type": "series"
          }
        ]
      }
    ]
  }
}

Detail

GET /public/api/v1/{provider}/detail?id={content_id}

Contoh:

curl "https://www.cutad.web.id/public/api/v1/dramabox/detail?id=abc123" \
  -H "X-API-Key: YOUR_KEY"

Cari Konten

GET /public/api/v1/{provider}/search?q={keyword}

Contoh:

# Cari anime "one piece"
curl "https://www.cutad.web.id/public/api/v1/anime/search?q=one+piece" \
  -H "X-API-Key: YOUR_KEY"

# Cari drama "love"
curl "https://www.cutad.web.id/public/api/v1/dramabox/search?q=love" \
  -H "X-API-Key: YOUR_KEY"

Episode (hanya beberapa provider)

GET /public/api/v1/{provider}/episodes?id={content_id}

Tonton / Video URL

GET /public/api/v1/{provider}/watch?id={content_id}

Info API Key Kamu

GET /public/api/v1/key/info

Membutuhkan API key. Mengembalikan info akun, jumlah request, dll.

Health Check

GET /public/api/v1/health

Tidak perlu API key. Cek status API.


⚙️ Rate Limit

Parameter Nilai
Limit 30 request / menit
Header response X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
Jika limit terlewati HTTP 429

Cek sisa limit dari response header:

curl -I https://www.cutad.web.id/public/api/v1/anime/rank \
  -H "X-API-Key: YOUR_KEY"

# Response headers:
# X-RateLimit-Limit: 30
# X-RateLimit-Remaining: 28
# X-RateLimit-Reset: 1712745600

🔑 Autentikasi

Dua cara mengirim API key:

# Cara 1: Header (recommended)
-H "X-API-Key: cutad_xxxxxxxxxxxx"

# Cara 2: Query parameter
"?api_key=cutad_xxxxxxxxxxxx"

📦 Contoh Kode

JavaScript (fetch)

const API_KEY = 'cutad_xxxxxxxxxxxx';
const BASE = 'https://www.cutad.web.id/public/api/v1';

// Ambil anime terpopuler
const res = await fetch(`${BASE}/anime/rank`, {
  headers: { 'X-API-Key': API_KEY }
});
const data = await res.json();
console.log(data);

Python (requests)

import requests

API_KEY = 'cutad_xxxxxxxxxxxx'
BASE = 'https://www.cutad.web.id/public/api/v1'

# Cari drama
res = requests.get(f'{BASE}/dramabox/search', 
    params={'q': 'love'},
    headers={'X-API-Key': API_KEY}
)
print(res.json())

cURL

# Daftar provider
curl https://www.cutad.web.id/public/api/v1/providers

# Cari donghua
curl "https://www.cutad.web.id/public/api/v1/donghua/search?q=martial" \
  -H "X-API-Key: YOUR_KEY"

# Ambil detail
curl "https://www.cutad.web.id/public/api/v1/anime/detail?id=abc123" \
  -H "X-API-Key: YOUR_KEY"

🚫 Error Handling

HTTP Code Arti
200 OK
400 Parameter kurang / salah
401 API key tidak dikirim
403 API key tidak valid
404 Provider atau action tidak ditemukan
429 Rate limit terlewati
500 Error di server / upstream

Contoh response error:

{
  "error": "Rate limit exceeded",
  "message": "Limit: 30 requests per minute. Try again after ...",
  "limit": 30,
  "remaining": 0,
  "resetAt": 1712745600
}

💡 Contoh Proyek yang Bisa Dibuat

  • 🤖 Bot Telegram / Discord untuk cek anime terbaru
  • 📱 Aplikasi mobile streaming
  • 🌐 Website agregator konten
  • 📊 Dashboard statistik konten
  • 🔔 Notifikasi episode baru

📖 Dokumentasi Lengkap

👉 cutad.web.id/docs


📜 Lisensi

MIT License — bebas digunakan, dimodifikasi, dan didistribusikan.


❤️ Dibuat oleh

CUTAD — Streaming Gratis Drama & Film Pendek Tanpa Iklan

About

Free streaming API — akses ribuan drama, anime, dan film gratis. Anime, Donghua, DramaBox, Melolo, MovieBox & more.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors