Dokumentasi API

API publik SaveDownX untuk mengambil informasi dan tautan unduhan dari video YouTube, TikTok, dan Instagram.

Autentikasi

API ini tidak memerlukan API key untuk penggunaan dasar. Setiap permintaan dibatasi menggunakan rate limit berbasis alamat IP.

Base URL

https://savedownx.web.id/api

Endpoint

GET /download

Mengambil metadata dan tautan unduhan dari sebuah link video.

Parameter Query

Nama	Tipe	Wajib	Keterangan
`url`	string	Ya	URL video dari YouTube, TikTok, atau Instagram (harus di-encode)

Contoh Request

GET https://savedownx.web.id/api/download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DVIDEO_ID

Contoh Response (200 OK)

{
  "status": "success",
  "data": {
    "title": "Judul Video",
    "thumbnail": "https://...jpg",
    "source_url": "https://www.youtube.com/watch?v=VIDEO_ID",
    "duration": null,
    "medias": [
      {
        "type": "video",
        "is_audio": false,
        "quality": "720p",
        "extension": "mp4",
        "bitrate": 1594543,
        "url": "https://..."
      }
    ]
  }
}

Contoh Response (Error)

{
  "status": "error",
  "message": "Platform belum didukung. Gunakan link YouTube, TikTok, atau Instagram."
}

GET /stats

Mengambil statistik publik penggunaan layanan (total unduhan, pengguna unik, dan distribusi platform).

Contoh Response

{
  "status": "success",
  "data": {
    "total_downloads": 15234,
    "total_users": 4210,
    "by_platform": {
      "youtube": 9800,
      "tiktok": 4100,
      "instagram": 1334,
      "other": 0
    }
  }
}

Kode Status

Kode	Arti
200	Berhasil
400	Parameter tidak valid atau platform tidak didukung
429	Terlalu banyak permintaan (rate limit tercapai)
500 / 502 / 504	Kesalahan pada server atau layanan sedang bermasalah

Rate Limit

Setiap alamat IP dibatasi maksimal 15 permintaan per 10 menit pada endpoint /download. Jika melebihi batas, API akan merespons dengan kode 429 beserta header Retry-After yang menunjukkan berapa detik lagi sebelum bisa mencoba kembali.

Platform yang Didukung

YouTube (youtube.com, youtu.be)
TikTok (tiktok.com)
Instagram (instagram.com — reels, video post)

Batasan Penggunaan

API ini disediakan gratis untuk penggunaan wajar (fair use).
Dilarang melakukan scraping massal, otomatisasi berlebihan, atau membangun layanan komersial di atas API ini tanpa izin.
Kami berhak memblokir IP yang terindikasi melakukan penyalahgunaan.
Tautan unduhan yang dihasilkan bersifat sementara dan dapat kedaluwarsa dalam beberapa jam.

Dukungan

Jika kamu menemukan bug atau memiliki pertanyaan seputar API, silakan sampaikan melalui kontak yang tertera di halaman Ketentuan Layanan.