Shikimori API

Anime / OAuth Advanced HTTPS
Varies by plan (check documentation)

Overview

Shikimori is a Russian-language anime and manga tracking platform whose API exposes anime metadata, user rates, forums, and calendar data. OAuth 2.0 is required for user-specific operations, making initial setup non-trivial. Developers building anime tracker apps targeting the Russian-speaking community will find this API most relevant.

💡

Beginner Tip

Some read-only endpoints like /api/animes work without OAuth if you include your app name in the User-Agent header. Register your application at shikimori.one/oauth/applications to get client credentials.

Available Data

track name and artist
album metadata
audio preview URLs
popularity score
genre classification
anime/manga title

Example Response

JSON Response
{
  "name": "Bohemian Rhapsody",
  "artist": "Queen",
  "album": "A Night at the Opera",
  "duration_ms": 354000,
  "popularity": 92,
  "preview_url": "https://p.scdn.co/mp3-preview/..."
}

Field Reference

id Shikimori unique identifier for the anime.
name The original Japanese/romaji title of the anime.
russian Russian-language title of the anime.
score Community average score as a decimal string (e.g. "8.4").
episodes Total planned or aired episode count.
status Airing status: anons, ongoing, or released.

Implementation Example

const url = "https://shikimori.one/api/doc";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized Missing OAuth token or invalid client credentials.
Complete the OAuth flow at shikimori.one/oauth/applications and pass the token as Authorization: Bearer <token>.
403 Forbidden Rate limit exceeded, Shikimori enforces 5 req/s and 90 req/min.
Slow down requests to stay within 5 per second and add the User-Agent header with your app name.
422 Unprocessable Entity Invalid filter parameters or unsupported query combinations.
Check the Shikimori API docs for supported filter keys; not all MAL-style filters apply here.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 3/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth OAuth
HTTPS REQUIRED
CORS UNKNOWN
Category Anime
Difficulty Advanced
Verified: 2026-04-04

Similar APIs

View All →