Jikan API

How to Use This API

1. Get Anime by ID (Cowboy Bebop = ID 1)

https://api.jikan.moe/v4/anime/1

Returns full details: title (English/Japanese), synopsis, score, rank, popularity, episode count, status (Finished Airing), aired dates, studios (Sunrise), genres, themes, and streaming links.

2. Search Anime by Title

https://api.jikan.moe/v4/anime?q=attack%20on%20titan&order_by=score&sort=desc

Search with q, order by score, popularity, episodes, or rank. Sort asc or desc.

3. Get Top Anime

https://api.jikan.moe/v4/top/anime

Returns the top-rated anime on MAL. Filter by type=tv, filter=airing, page.

4. JavaScript — Anime Search

async function searchAnime(query) {
  const resp = await fetch(
    `https://api.jikan.moe/v4/anime?q=${encodeURIComponent(query)}&limit=5`
  );
  const data = await resp.json();
  return data.data.map(a => ({
    title: a.title,
    english: a.title_english,
    score: a.score,
    episodes: a.episodes,
    status: a.status,
    synopsis: a.synopsis?.substring(0, 150) + '...',
    image: a.images.jpg.image_url,
    url: a.url
  }));
}

searchAnime('spirited away').then(results => {
  results.forEach(a => {
    console.log(`${a.title} ⭐${a.score} (${a.episodes} eps)`);
  });
});

5. Python — Get Seasonal Anime

import requests
from datetime import datetime

def get_current_season():
    now = datetime.now()
    year = now.year
    month = now.month
    season_map = {1: 'winter', 4: 'spring', 7: 'summer', 10: 'fall'}
    season = season_map.get(((month - 1) // 3) * 4 + 1, 'spring')
    return season, year

season, year = get_current_season()
resp = requests.get(
    f'https://api.jikan.moe/v4/seasons/{year}/{season}'
)
anime_list = resp.json()['data']

print(f"Top {season.capitalize()} {year} anime:")
for a in anime_list[:10]:
    print(f"  {a['title']} — ⭐{a['score'] or 'N/A'} "
          f"({a['episodes'] or '?'} eps)")