Rannz Anime API | Rannz API Factory

GET/api/v1/anime/searchFreecache 1 jam

Cari anime berdasarkan judul

Pencarian judul dengan pagination. Konten dewasa disaring secara default (sfw=true).

Parameter	Lokasi	Tipe	Wajib	Keterangan
q	query	string	Ya	Kata kunci judul.
page	query	integer	Tidak	Nomor halaman. Default: 1. Rentang: 1 - 100.
limit	query	integer	Tidak	Item per halaman. Default: 10. Rentang: 1 - 25.
sfw	query	boolean	Tidak	Saring konten dewasa. Default: true.

Contoh request

curl "https://layananapirannz.web.id/api/v1/anime/search?q=naruto" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/v1/anime/topPremiumcache 1 jam

Peringkat anime teratas

Daftar anime teratas, dapat difilter (sedang tayang, akan tayang, populer, favorit). Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
filter	query	airing \| upcoming \| bypopularity \| favorite	Tidak	Filter peringkat.
page	query	integer	Tidak	Nomor halaman. Default: 1. Rentang: 1 - 100.
limit	query	integer	Tidak	Item per halaman. Default: 10. Rentang: 1 - 25.

Contoh request

curl "https://layananapirannz.web.id/api/v1/anime/top?filter=airing" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "items": [
      {
        "id": 20,
        "url": "https://myanimelist.net/anime/20/Naruto",
        "title": "Naruto",
        "titleEnglish": "Naruto",
        "titleJapanese": "ナルト",
        "type": "TV",
        "episodes": 220,
        "status": "Finished Airing",
        "score": 8,
        "rank": 700,
        "popularity": 10,
        "year": 2002,
        "season": "fall",
        "synopsis": "Ringkasan cerita (contoh, dipotong)...",
        "genres": [
          "Action",
          "Adventure",
          "Fantasy"
        ],
        "studios": [
          "Pierrot"
        ],
        "image": "https://cdn.myanimelist.net/images/anime/example.jpg"
      }
    ],
    "page": 1,
    "hasNextPage": true,
    "lastPage": 40,
    "total": 1000
  },
  "meta": {
    "requestId": "…",
    "endpoint": "anime.top",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "filter",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/anime/:idPremiumcache 1 jam

Detail anime berdasarkan ID MyAnimeList

Detail lengkap satu anime termasuk sinopsis, genre, dan studio. Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
id	path	string	Ya	ID MyAnimeList.

Contoh request

curl "https://layananapirannz.web.id/api/v1/anime/20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "id": 20,
    "url": "https://myanimelist.net/anime/20/Naruto",
    "title": "Naruto",
    "titleEnglish": "Naruto",
    "titleJapanese": "ナルト",
    "type": "TV",
    "episodes": 220,
    "status": "Finished Airing",
    "score": 8,
    "rank": 700,
    "popularity": 10,
    "year": 2002,
    "season": "fall",
    "synopsis": "Ringkasan cerita (contoh, dipotong)...",
    "genres": [
      "Action",
      "Adventure",
      "Fantasy"
    ],
    "studios": [
      "Pierrot"
    ],
    "image": "https://cdn.myanimelist.net/images/anime/example.jpg"
  },
  "meta": {
    "requestId": "…",
    "endpoint": "anime.detail",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "id",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

Endpoint (3)

Cari anime berdasarkan judul

Contoh request

Contoh respons sukses (200)

Contoh respons error

Peringkat anime teratas

Contoh request

Contoh respons sukses (200)

Contoh respons error

Detail anime berdasarkan ID MyAnimeList

Contoh request

Contoh respons sukses (200)

Contoh respons error