<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Hasan · MyAnimeDex</title>
    <description>The latest articles on DEV Community by Hasan · MyAnimeDex (@animedex_80b88d040a58d723).</description>
    <link>https://dev.to/animedex_80b88d040a58d723</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4254453%2Fe6447854-e775-4b24-8d8c-8fe8e16e2e82.png</url>
      <title>DEV Community: Hasan · MyAnimeDex</title>
      <link>https://dev.to/animedex_80b88d040a58d723</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/animedex_80b88d040a58d723"/>
    <language>en</language>
    <item>
      <title>Jikan shut down. Here's how I moved my anime app to AniList without rewriting every screen</title>
      <dc:creator>Hasan · MyAnimeDex</dc:creator>
      <pubDate>Thu, 19 Nov 2026 20:18:03 +0000</pubDate>
      <link>https://dev.to/animedex_80b88d040a58d723/jikan-shut-down-heres-how-i-moved-my-anime-app-to-anilist-without-rewriting-every-screen-6a3</link>
      <guid>https://dev.to/animedex_80b88d040a58d723/jikan-shut-down-heres-how-i-moved-my-anime-app-to-anilist-without-rewriting-every-screen-6a3</guid>
      <description>&lt;p&gt;In September 2026 the Jikan API, the unofficial MyAnimeList REST API that a lot of hobby anime apps were built on, went offline. My app, MyAnimeDex (a free anime tracker for iOS and Android), used it on almost every screen: search, anime details, seasonal charts, recommendations.&lt;/p&gt;

&lt;p&gt;This is how I moved everything to the AniList GraphQL API without touching most of those screens, and the rate-limit bugs I hit on the way.&lt;/p&gt;

&lt;h2&gt;
  
  
  The trick: keep the old shape, change what's behind it
&lt;/h2&gt;

&lt;p&gt;Screens imported one module, &lt;code&gt;lib/jikan.ts&lt;/code&gt;, and used Jikan-shaped objects: &lt;code&gt;mal_id&lt;/code&gt;, &lt;code&gt;images.jpg.large_image_url&lt;/code&gt;, &lt;code&gt;genres: [{ mal_id, name }]&lt;/code&gt; and so on. Rewriting the home screen, anime details, lists, onboarding, the dice picker and the recommendation service to AniList's shape at once would have broken things I couldn't easily test.&lt;/p&gt;

&lt;p&gt;Instead &lt;code&gt;lib/jikan.ts&lt;/code&gt; kept its exports and types, and started delegating to a new AniList service. A normalizer converts each AniList &lt;code&gt;Media&lt;/code&gt; object into the old shape:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="kd"&gt;const&lt;/span&gt; &lt;span class="n"&gt;toAnime&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="n"&gt;mal_id&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;idMal&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;romaji&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;title_english&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;title&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;english&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;images&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;jpg&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;large_image_url&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;coverImage&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;extraLarge&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;score&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;averageScore&lt;/span&gt; &lt;span class="o"&gt;?&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;averageScore&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt; &lt;span class="mi"&gt;10&lt;/span&gt; &lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="n"&gt;genres&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;media&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;genres&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;map&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="c1"&gt;// ...&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Two details mattered more than I expected:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;IDs.&lt;/strong&gt; Users' lists stored MyAnimeList IDs. AniList exposes them as &lt;code&gt;idMal&lt;/code&gt;, but not every entry has one. Every lookup goes &lt;code&gt;idMal&lt;/code&gt; first, then the AniList &lt;code&gt;id&lt;/code&gt;, and the normalizer writes &lt;code&gt;idMal || id&lt;/code&gt; back into &lt;code&gt;mal_id&lt;/code&gt;. The name is historical now, but nothing that reads it had to change.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Genres.&lt;/strong&gt; Some old queries filtered by Jikan genre IDs (1 = Action, 4 = Comedy...). AniList filters by genre name, so a small lookup table translates IDs to names at the boundary.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Rate limits will find you
&lt;/h2&gt;

&lt;p&gt;AniList allows roughly 90 requests a minute, and less when the service is under load. My home screen fired a handful of parallel queries; the calendar fired one per day. On a busy day that was enough to hit HTTP 429, retry immediately, hit 429 again and loop.&lt;/p&gt;

&lt;p&gt;The fix was a single entry point for every request:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;A request queue.&lt;/strong&gt; Each call reserves the next slot, at least 350 ms after the previous one. Parallel calls from different screens line up instead of bursting.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Respect Retry-After.&lt;/strong&gt; On HTTP 429 the client waits for the &lt;code&gt;Retry-After&lt;/code&gt; header (3.5 s if it's missing) and retries a limited number of times. AniList can also return rate-limit errors inside a 200 GraphQL response, so those are handled the same way.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Cache by key.&lt;/strong&gt; Calls that pass a &lt;code&gt;cacheKey&lt;/code&gt; reuse the result for a while, so navigating back and forth doesn't refetch.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Stale-if-error on disk.&lt;/strong&gt; Important calls also save their last good response to disk. When the network or AniList is down, the app shows that instead of an empty screen.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;After this, the rate-limit loops that had been my most persistent bug stopped.&lt;/p&gt;

&lt;h2&gt;
  
  
  Things I'd do the same way again
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;One HTTP entry point.&lt;/strong&gt; Throttling, retries and caching live in one function, so a new screen can't accidentally bypass them.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Normalize at the edge.&lt;/strong&gt; The rest of the app doesn't know which API it talks to. If AniList changes, one file changes.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Batch with aliases.&lt;/strong&gt; GraphQL lets you ask for several media in one request (&lt;code&gt;a0: Media(id: 1) {...} a1: Media(id: 5) {...}&lt;/code&gt;). For build scripts that fetch 100 anime, five per request with a pause between them stays well under the limit.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  If you're still on Jikan
&lt;/h2&gt;

&lt;p&gt;Start with the facade, not the screens: one module that keeps your current data shape and talks to the new API behind it. Then put every request through one throttled client before you ship. In my case the rate-limit loops were harder to track down than the data mapping.&lt;/p&gt;

&lt;p&gt;If you're maintaining a Jikan-based app and need to switch, I'm happy to answer questions in the comments.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;This post was written with an AI assistant, based on my app's source code.&lt;/em&gt;&lt;/p&gt;

</description>
      <category>reactnative</category>
      <category>graphql</category>
      <category>mobile</category>
      <category>showdev</category>
    </item>
  </channel>
</rss>
