Jikan

FREE
By API Guy | Updated 2 years ago | Entertainment
Popularity

0.4 / 10

Latency

626ms

Service Level

100%

Jikan Overview

README

Jikan (時間) is an open-source PHP & REST API for the “most active online anime + manga community and database” — MyAnimeList. It parses the website to satisfy the need for an API.

<div><div>

Jikan  

<div><div>

<div>
<h3>Introduction</h3>
</div>

  <div>
  <p><a href="https://jikan.moe">Jikan</a> is an <strong>Unofficial</strong> MyAnimeList API.

It’s built on the Lumen microframework, uses Redis for caching and is powered by the <a href=“https://github.com/jikan-me/jikan”>Jikan PHP API</a>.</p>
<p><strong>API Path:</strong> <code>https://api.jikan.moe/v3</code></p>
<p><strong>API Version</strong>: <code>v3.4 RC</code></p>
<p><a href=“https://status.jikan.moe”>Status</a> | <a href=“https://github.com/jikan-me/jikan/issues/new”>Report an Issue</a> | <strong><a href=“https://discordapp.com/invite/4tvCr36”>Discord</a></strong></p>
Information
Links
<ul>
<li>
<p><a href=“https://jikan.moe”>Jikan.moe</a></p>
</li>
<li>
<p><a href=“https://jikan.moe/about”>About</a></p>
</li>
<li>
<p><a href=“https://jikan.moe/showcase”>Projects/Apps using Jikan</a></p>
</li>
</ul>
Wrappers
<ul>
<li>
<p><a href=“https://github.com/jikan-me/jikan/”>PHP API - JikanPHP</a> by <a href=“https://github.com/jikan-me/jikan/graphs/contributors”>Contributors</a></p>
</li>
<li>
<p><a href=“https://github.com/AWConant/jikanpy”>Python - JikanPy</a> by Andrew Conant & abhinavk99 (Abhinav Kasamsetty)</p>
</li>
<li>
<p><a href=“https://github.com/Zerocchi/jikan.rb”>Ruby - Jikan.rb</a> by Zerocchi</p>
</li>
<li>
<p><a href=“https://github.com/Ervie/jikan.net”>.NET/C# - Jikan.Net</a> by Ervie (Bartłomiej Buchała)</p>
</li>
<li>
<p><a href=“https://github.com/zuritor/jikanjs”>JavaScript - JikanJs</a> by zuritor (Sven)</p>
</li>
<li>
<p><a href=“https://github.com/Doomsdayrs/Jikan4java”>Java - Jikan4java</a> by Doomsdayrs</p>
</li>
<li>
<p><a href=“https://github.com/janvernieuwe/jikan-jikanPHP”>PHP - Jikan-php</a> by Jan Vernieuwe</p>
</li>
<li>
<p><a href=“https://github.com/xy137/jikan-node”>NodeJS - Jikan-node</a> by xy137</p>
</li>
<li>
<p><a href=“https://github.com/charafau/jikan-dart”>Dart - Jikan-dart</a> by Rafal Wachol</p>
</li>
<li>
<p><a href=“https://github.com/Julien-Broyard/jikants”>TypeScript - Jikants</a> by Julien Broyard</p>
</li>
<li>
<p><a href=“https://github.com/javi11/jikan-client”>TypeScript - jikan-client</a> by Javier Blanco</p>
</li>
<li>
<p><a href=“https://github.com/darenliang/jikan-go”>Go - Jikan-go</a> by Daren Liang</p>
</li>
</ul>
<p><a href=“https://github.com/jikan-me/jikan-rest/edit/master/apiary.apib”>Add your wrapper here!</a></p>
Rate Limiting
<p>Daily Limit: <strong>Unlimited</strong></p>
<ul>
<li>
<p><strong>30 requests</strong> / minute</p>
</li>
<li>
<p><strong>2 requests</strong> / second</p>
</li>
</ul>
<p><strong>Note: Cached requests are NOT throttled</strong></p>
Bulk Requests
<p>This API serves as a purpose for apps/projects that are user based and make a nominal amount of requests.</p>
<p>⚠️ If you’re using the service for the sake of populating data/making your own database;</p>
<ul>
<li>
<p>You are breaching <a href=“https://myanimelist.net/membership/terms_of_use”>MyAnimeList’s Terms Of Service</a>. <strong>You are responsible for what you’re doing.</strong></p>
</li>
<li>
<p><strong>You MUST use a delay of 4 (FOUR) SECONDS between each request</strong></p>
</li>
<li>
<p>Requesting from multiple servers/IPs is being cheeky and is <strong>NOT</strong> allowed</p>
</li>
<li>
<p><strong>ABUSING THE API WILL RESULT IN GETTING BLOCKED FROM THE SERVICE</strong></p>
</li>
</ul>
<p>If you’re not comfortable being that restrictive, consider setting up your own Jikan REST API - It’s super easy.</p>
<ul>
<li>
<p><a href=“https://github.com/jikan-me/jikan-rest”>Jikan REST API - GitHub</a></p>
</li>
<li>
<p><a href=“https://github.com/fethica/jikan-rest-docker”>Jikan REST API - Docker</a></p>
</li>
</ul>
Disclaimer
<ul>
<li>
<p>Jikan is not affiliated with MyAnimeList.net</p>
</li>
<li>
<p>Jikan is a <strong>free</strong>, open-source API. Use it responsibly!</p>
</li>
</ul>
JSON Notes
<ul>
<li>
<p>Any property (except arrays) whose value does not exist or is undertermined, will be <code>null</code></p>
</li>
<li>
<p>Any array property whose value does not exist or is undetermined, will be <strong>empty</strong></p>
</li>
<li>
<p>Any <code>score</code> property whose value does not exist or is undetermined, will be <code>0</code></p>
</li>
<li>
<p>All dates and timestamps are returned in <strong>ISO8601</strong> format and in <strong>UTC</strong></p>
</li>
</ul>
Caching
<p>By “caching”, we refer to the data parsed from MyAnimeList that is cached temporarily on our servers for performance/faster responses.</p>
<p>All requests by default are cached for <strong>24 hours</strong> except for a few API endpoints which have their own unique cache expiry time.</p>
<table>
<thead>
<tr>
<th>Request</th>
<th>Cache TTL</th>
</tr>
</thead>
<tbody>
<tr>
<td>All (Default)</td>
<td>24 hours</td>
</tr>
<tr>
<td>Meta</td>
<td>5 minutes</td>
</tr>
<tr>
<td>User</td>
<td>5 minutes</td>
</tr>
<tr>
<td>Search</td>
<td>120 hours (5 days)</td>
</tr>
</tbody>
</table>
<p>The following Response Headers will detail cache information</p>
<table>
<thead>
<tr>
<th>Header</th>
<th>Remarks</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Expires</code></td>
<td>Expiry timestamp for the cache</td>
</tr>
<tr>
<td><code>X-Request-Cached</code></td>
<td>(boolean) Is the request cached?</td>
</tr>
<tr>
<td><code>X-Request-Cache-Ttl</code></td>
<td>(integer) Cache Time-To-Live in seconds</td>
</tr>
</tbody>
</table>
<p><strong>FAQ: Why is <code>X-Request-Cache-Ttl</code> negative?</strong></p>
<p>Jikan REST API v3.3+ uses a different caching logic. If the cache expires, it queues a job in the background to update the cache.
So you’re getting stale cache until the cache update completes.</p>
Allowed HTTP(s) requests
<pre>GET: All requests are done via GET
</pre>
<p><strong>The Jikan REST API does not provide authenticated requests for MyAnimeList.</strong>
This means you can not use it to update your anime/manga lists.</p>
<p><strong>Reasons:</strong></p>
<ul>
<li>
<p>Why on earth would you send your credentials to a 3rd party API?</p>
</li>
<li>
<p>MyAnimeList will block our IP after multiple failed login attempts</p>
</li>
</ul>
<p>However, do not fret. This is possible via their own website. <a href=“https://github.com/jikan-me/jikan-auth/blob/master/SPECIFICATION.md”>Read the Specification</a></p>
<p>Furthermore, <a href=“https://github.com/jikan-me/jikan-auth”>JikanAuth</a> is a PHP API which you can use to update your lists - it implements the <strong>Specification</strong> above. So feel free to come up with your own client-side solution.</p>
HTTP Response
<ul>
<li>
<p>200 <code>OK</code> - the request was successful.</p>
</li>
<li>
<p>304 <code>Not Modified</code> - You have the latest data</p>
</li>
<li>
<p>400 <code>Bad Request</code> - You’ve made an invalid request or to an invalid endpoint.</p>
</li>
<li>
<p>404 <code>Not Found</code> - MyAnimeList responded with a 404</p>
</li>
<li>
<p>405 <code>Method Not Allowed</code> - requested method is not supported for resource.</p>
</li>
<li>
<p>429 <code>Too Many Requests</code> - You are being rate limited or Jikan is being rate-limited by MyAnimeList</p>
</li>
<li>
<p>500 <code>Internal Server Error</code> - Something broke on our end :(</p>
</li>
</ul>
JSON Error Response
<p>This is a typical error response</p>
<pre><code>{
“status”: 404,
“type”: “BadResponseException”,
“message”: “Resource does not exist”
“error”: “Something Happened”
}
</code></pre>
<table>
<thead>
<tr>
<th>Property</th>
<th>Remarks</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>status</code></td>
<td>HTTP Status returned</td>
</tr>
<tr>
<td><code>type</code></td>
<td><code>Exception</code> generated from the PHP API</td>
</tr>
<tr>
<td><code>message</code></td>
<td>Appropriate error message from the REST API</td>
</tr>
<tr>
<td><code>error</code></td>
<td>Error response from the PHP API</td>
</tr>
<tr>
<td><code>report_url</code> (fatal errors only)</td>
<td>Clicking on this would redirect you to a generated GitHub Issue</td>
</tr>
</tbody>
</table>
Cache Validation
<ul>
<li>
<p>All requests return a <code>ETag</code> header which is an md5 hash of the content.</p>
</li>
<li>
<p>You can use this hash to verify if there’s new or updated content by supplying it as the value for the <code>If-None-Match</code> header.</p>
</li>
<li>
<p>You will get a <code>304</code> HTTP response if your value and the data on Jikan matches.</p>
</li>
<li>
<p>If there’s new/updated content, you’ll get a normal <code>200</code> HTTP response with the updated content.</p>
</li>
</ul>
<h3>How To Use</h3>
<ol>
<li>
<p>Use the <code>ETag</code> value as a header value for <code>If-None-Match</code> for future requests</p>
</li>
<li>
<p>If the content has changed, you will get a <code>304 - Not Modified</code> header response, otherwise <code>200 - OK</code></p>
</li>
</ol>
<p></p> </div>

</div></div>
<div></div>
<div><div>

<div>
<h3>Reference</h3>
</div>

<div>
<div>

<div><div>

Anime  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>A single anime object with all its details</p>

<p><strong>Endpoint Path:</strong> <code>/anime/{id}(/request)</code></p>
<h3>Requests</h3>
<table>
<thead>
<tr>
<th>Request</th>
<th>Parameter</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>/</code></td>
<td>N/A</td>
<td>Resource object with all it’s details</td>
</tr>
<tr>
<td><code>/characters_staff</code></td>
<td>N/A</td>
<td>List of character and staff members</td>
</tr>
<tr>
<td><code>/episodes</code></td>
<td>Page number (integer)</td>
<td>List of episodes</td>
</tr>
<tr>
<td><code>/news</code></td>
<td>N/A</td>
<td>List of Related news</td>
</tr>
<tr>
<td><code>/pictures</code></td>
<td>N/A</td>
<td>List of Related pictures</td>
</tr>
<tr>
<td><code>/videos</code></td>
<td>N/A</td>
<td>List o fPromotional Videos & episodes (if any)</td>
</tr>
<tr>
<td><code>/stats</code></td>
<td>N/A</td>
<td>Related statistical information</td>
</tr>
<tr>
<td><code>/forum</code></td>
<td>N/A</td>
<td>List of Related forum topics</td>
</tr>
<tr>
<td><code>/moreinfo</code></td>
<td>N/A</td>
<td>A string of more information (if any)</td>
</tr>
<tr>
<td><code>/reviews</code></td>
<td>Page number (integer)</td>
<td>List of Reviews written by users</td>
</tr>
<tr>
<td><code>/recommendations</code></td>
<td>N/A</td>
<td>List of Recommendations and their weightage made by users</td>
</tr>
<tr>
<td><code>/userupdates</code></td>
<td>Page number (integer)</td>
<td>List of the latest list updates made by users</td>
</tr>
</tbody>
</table>
<h4>Remarks</h4>
<h5><code>/episodes</code></h5>
<ul>
<li>
<p>The field <code>episodes_last_page</code> will tell you the last page of the paginated episodes list.</p>
</li>
<li>
<p>The episodes page on MyAnimeList get paginated after 100 episodes. If there’s an anime with more than 100 episodes, you’ll have to use the parameter.</p>
</li>
</ul>
<h5><code>/reviews</code></h5>
<ul>
<li>Only 20 items are shown per page for reviews</li>
</ul>
<h3>Examples</h3>
<ul>
<li>
<p><code>/anime/1/characters_staff</code> // Returns the list of characters and staff</p>
</li>
<li>
<p><code>/anime/1/episodes</code> // Defaults to the 1st page</p>
</li>
<li>
<p><code>/anime/1/episodes/1</code> // Same as above</p>
</li>
<li>
<p><code>/anime/1/episodes/2</code> // Returns 2nd page if there’s any</p>
</li>
</ul> </div>

<div><div>

<div>
<a href="/reference/0/anime/fetch-resource">
<div></div>

  <h4>
    Fetch Resource      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Manga  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>A single manga object with all its details</p>

<h3>Requests</h3>
<table>
<thead>
<tr>
<th>Request</th>
<th>Parameter</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>characters</td>
<td>N/A</td>
<td>Fetches the list of characters & staff members of the manga</td>
</tr>
<tr>
<td>news</td>
<td>N/A</td>
<td>News related to the item</td>
</tr>
<tr>
<td>pictures</td>
<td>N/A</td>
<td>Pictures related to the item</td>
</tr>
<tr>
<td>stats</td>
<td>N/A</td>
<td>Statistical information related to the item</td>
</tr>
<tr>
<td>forum</td>
<td>N/A</td>
<td>Forum topics related to the item</td>
</tr>
<tr>
<td>moreinfo</td>
<td>N/A</td>
<td>More info related to the item</td>
</tr>
<tr>
<td>reviews</td>
<td>Page number (integer)</td>
<td>Reviews written by users</td>
</tr>
<tr>
<td>recommendations</td>
<td>N/A</td>
<td>Recommendations and their weightage made by users</td>
</tr>
<tr>
<td>userupdates</td>
<td>Page number (integer)</td>
<td>Latest list updates made by users</td>
</tr>
</tbody>
</table>
<h3>Example Calls</h3>
<ul>
<li><code>/manga/1/characters</code> // Returns the list of characters and staff</li>
</ul>
<h4>Remarks</h4>
<ul>
<li>Only 20 items are shown per page for reviews</li>
</ul> </div>

<div><div>

<div>
<a href="/reference/0/manga/manga-request-example+schema">
<div></div>

  <h4>
    Manga Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Person  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>A single person object with all its details</p>

<h3>Requests</h3>
<table>
<thead>
<tr>
<th>Request</th>
<th>Parameter</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>pictures</td>
<td>N/A</td>
<td>Pictures related to the item</td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/person/person-request-example+schema">
<div></div>

  <h4>
    Person Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Character  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>A single character object with all its details</p>

<h3>Requests</h3>
<table>
<thead>
<tr>
<th>Request</th>
<th>Parameter</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>pictures</td>
<td>N/A</td>
<td>Pictures related to the item</td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/character/character-request-example+schema">
<div></div>

  <h4>
    Character Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Search  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Search results for the query</p>

<p><strong>NOTE: MyAnimeList only processes queries with a minimum of 3 letters.</strong> However, the search function can be used without <code>q</code>! Check examples below for more details.</p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td>anime, manga, person, character</td>
<td>Specify where to search</td>
</tr>
<tr>
<td>page</td>
<td>INTEGER</td>
<td>Page number of the results</td>
</tr>
</tbody>
</table>
<h3>Advanced Search Parameters (Anime & Manga)</h3>
<p><strong>Note:</strong> These are search filters which have to be passed as GET <code>key=value</code></p>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>q</td>
<td>STRING</td>
<td>For UTF8 characters, percentage encoded and queries including back slashes</td>
</tr>
<tr>
<td>page</td>
<td>INTEGER</td>
<td>Page number</td>
</tr>
<tr>
<td>type</td>
<td><strong>See Enums Below</strong></td>
<td>Filter type of results</td>
</tr>
<tr>
<td>status</td>
<td><strong>See Enums Below</strong></td>
<td>Filter status of results</td>
</tr>
<tr>
<td>rated</td>
<td><strong>See Enums Below</strong></td>
<td>Filter age rating of results</td>
</tr>
<tr>
<td>genre</td>
<td><strong>See Enums Below</strong></td>
<td>Filter by genre ID(s)</td>
</tr>
<tr>
<td>score</td>
<td>FLOAT : 0.0-10.0</td>
<td>Filter score of results</td>
</tr>
<tr>
<td>start_date</td>
<td><code>yyyy-mm-dd</code></td>
<td>Filter start date of results</td>
</tr>
<tr>
<td>end_date</td>
<td><code>yyyy-mm-dd</code></td>
<td>Filter end date of results</td>
</tr>
<tr>
<td>genre_exclude</td>
<td>boolean : 0/1</td>
<td>To exlude/include the <code>genre</code> you added in your request</td>
</tr>
<tr>
<td>limit</td>
<td>INTEGER</td>
<td>Limits item results to the number specified</td>
</tr>
<tr>
<td>order_by</td>
<td><strong>See Enums Below</strong></td>
<td>Order results with respect to a property</td>
</tr>
<tr>
<td>sort</td>
<td><strong>See Enums Below</strong></td>
<td>Sort <code>order_by</code> (Default is <code>descending</code>)</td>
</tr>
<tr>
<td>producer</td>
<td>INTEGER</td>
<td>MAL ID of the producer</td>
</tr>
<tr>
<td>magazine</td>
<td>INTEGER</td>
<td>MAL ID of the magazine</td>
</tr>
<tr>
<td>letter</td>
<td>UTF8 Character</td>
<td>Search anime or manga by the letter/character it starts with</td>
</tr>
</tbody>
</table>
<h4>Enums</h4>
<h5><code>type</code></h5>
<table>
<thead>
<tr>
<th>Anime Types</th>
<th>Manga Types</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>tv</code></td>
<td><code>manga</code></td>
</tr>
<tr>
<td><code>ova</code></td>
<td><code>novel</code></td>
</tr>
<tr>
<td><code>movie</code></td>
<td><code>oneshot</code></td>
</tr>
<tr>
<td><code>special</code></td>
<td><code>doujin</code></td>
</tr>
<tr>
<td><code>ona</code></td>
<td><code>manhwa</code></td>
</tr>
<tr>
<td><code>music</code></td>
<td><code>manhua</code></td>
</tr>
</tbody>
</table>
<h5><code>status</code></h5>
<table>
<thead>
<tr>
<th>Anime Status</th>
<th>Manga Status</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>airing</code></td>
<td><code>publishing</code></td>
</tr>
<tr>
<td><code>completed</code></td>
<td><code>completed</code></td>
</tr>
<tr>
<td><code>complete</code> (alias)</td>
<td><code>complete</code> (alias)</td>
</tr>
<tr>
<td><code>to_be_aired</code></td>
<td><code>to_be_published</code></td>
</tr>
<tr>
<td><code>tba</code> (alias)</td>
<td><code>tbp</code> (alias)</td>
</tr>
<tr>
<td><code>upcoming</code> (alias)</td>
<td><code>upcoming</code> (alias)</td>
</tr>
</tbody>
</table>
<h5><code>rated</code></h5>
<p>Anime ratings are based on MyAnimeList’s rating system.
Read more about them <a href=“https://myanimelist.net/info.php?go=mpaa”>here</a></p>
<table>
<thead>
<tr>
<th>Anime Search</th>
<th>Remarks</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>g</code></td>
<td><strong>G</strong> - All Ages</td>
</tr>
<tr>
<td><code>pg</code></td>
<td><strong>PG</strong> - Children</td>
</tr>
<tr>
<td><code>pg13</code></td>
<td><strong>PG-13</strong> - Teens 13 or older</td>
</tr>
<tr>
<td><code>r17</code></td>
<td><strong>R</strong> - 17+ recommended (violence & profanity)</td>
</tr>
<tr>
<td><code>r</code></td>
<td><strong>R+</strong> - Mild Nudity (may also contain violence & profanity)</td>
</tr>
<tr>
<td><code>rx</code></td>
<td><strong>Rx</strong> - Hentai (extreme sexual content/nudity)</td>
</tr>
</tbody>
</table>
<h5><code>order_by</code></h5>
<table>
<thead>
<tr>
<th>Anime Search</th>
<th>Manga Search</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>title</code></td>
<td><code>title</code></td>
</tr>
<tr>
<td><code>start_date</code></td>
<td><code>start_date</code></td>
</tr>
<tr>
<td><code>end_date</code></td>
<td><code>end_date</code></td>
</tr>
<tr>
<td><code>score</code></td>
<td><code>score</code></td>
</tr>
<tr>
<td><code>type</code></td>
<td><code>type</code></td>
</tr>
<tr>
<td><code>members</code></td>
<td><code>members</code></td>
</tr>
<tr>
<td><code>id</code></td>
<td><code>id</code></td>
</tr>
<tr>
<td><code>episodes</code></td>
<td><code>chapters</code></td>
</tr>
<tr>
<td><code>rating</code></td>
<td><code>volumes</code></td>
</tr>
</tbody>
</table>
<h5><code>sort</code></h5>
<table>
<thead>
<tr>
<th>Anime & Manga Sort</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ascending</code></td>
</tr>
<tr>
<td><code>asc</code> (alias)</td>
</tr>
<tr>
<td><code>descending</code></td>
</tr>
<tr>
<td><code>desc</code> (alias)</td>
</tr>
</tbody>
</table>
<h5><code>genre</code></h5>
<table>
<thead>
<tr>
<th>Anime Genre</th>
<th>Manga Genre</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Action:</strong> <code>1</code></td>
<td><strong>Action:</strong> <code>1</code></td>
</tr>
<tr>
<td><strong>Adventure:</strong> <code>2</code></td>
<td><strong>Adventure:</strong> <code>2</code></td>
</tr>
<tr>
<td><strong>Cars:</strong> <code>3</code></td>
<td><strong>Cars:</strong> <code>3</code></td>
</tr>
<tr>
<td><strong>Comedy:</strong> <code>4</code></td>
<td><strong>Comedy:</strong> <code>4</code></td>
</tr>
<tr>
<td><strong>Dementia:</strong> <code>5</code></td>
<td><strong>Dementia:</strong> <code>5</code></td>
</tr>
<tr>
<td><strong>Demons:</strong> <code>6</code></td>
<td><strong>Demons:</strong> <code>6</code></td>
</tr>
<tr>
<td><strong>Mystery:</strong> <code>7</code></td>
<td><strong>Mystery:</strong> <code>7</code></td>
</tr>
<tr>
<td><strong>Drama:</strong> <code>8</code></td>
<td><strong>Drama:</strong> <code>8</code></td>
</tr>
<tr>
<td><strong>Ecchi:</strong> <code>9</code></td>
<td><strong>Ecchi:</strong> <code>9</code></td>
</tr>
<tr>
<td><strong>Fantasy:</strong> <code>10</code></td>
<td><strong>Fantasy:</strong> <code>10</code></td>
</tr>
<tr>
<td><strong>Game:</strong> <code>11</code></td>
<td><strong>Game:</strong> <code>11</code></td>
</tr>
<tr>
<td><strong>Hentai:</strong> <code>12</code></td>
<td><strong>Hentai:</strong> <code>12</code></td>
</tr>
<tr>
<td><strong>Historical:</strong> <code>13</code></td>
<td><strong>Historical:</strong> <code>13</code></td>
</tr>
<tr>
<td><strong>Horror:</strong> <code>14</code></td>
<td><strong>Horror:</strong> <code>14</code></td>
</tr>
<tr>
<td><strong>Kids:</strong> <code>15</code></td>
<td><strong>Kids:</strong> <code>15</code></td>
</tr>
<tr>
<td><strong>Magic:</strong> <code>16</code></td>
<td><strong>Magic:</strong> <code>16</code></td>
</tr>
<tr>
<td><strong>Martial Arts:</strong> <code>17</code></td>
<td><strong>Martial Arts:</strong> <code>17</code></td>
</tr>
<tr>
<td><strong>Mecha:</strong> <code>18</code></td>
<td><strong>Mecha:</strong> <code>18</code></td>
</tr>
<tr>
<td><strong>Music:</strong> <code>19</code></td>
<td><strong>Music:</strong> <code>19</code></td>
</tr>
<tr>
<td><strong>Parody:</strong> <code>20</code></td>
<td><strong>Parody:</strong> <code>20</code></td>
</tr>
<tr>
<td><strong>Samurai:</strong> <code>21</code></td>
<td><strong>Samurai:</strong> <code>21</code></td>
</tr>
<tr>
<td><strong>Romance:</strong> <code>22</code></td>
<td><strong>Romance:</strong> <code>22</code></td>
</tr>
<tr>
<td><strong>School:</strong> <code>23</code></td>
<td><strong>School:</strong> <code>23</code></td>
</tr>
<tr>
<td><strong>Sci Fi:</strong> <code>24</code></td>
<td><strong>Sci Fi:</strong> <code>24</code></td>
</tr>
<tr>
<td><strong>Shoujo:</strong> <code>25</code></td>
<td><strong>Shoujo:</strong> <code>25</code></td>
</tr>
<tr>
<td><strong>Shoujo Ai:</strong> <code>26</code></td>
<td><strong>Shoujo Ai:</strong> <code>26</code></td>
</tr>
<tr>
<td><strong>Shounen:</strong> <code>27</code></td>
<td><strong>Shounen:</strong> <code>27</code></td>
</tr>
<tr>
<td><strong>Shounen Ai:</strong> <code>28</code></td>
<td><em>Shounen Ai</em>: <code>28</code></td>
</tr>
<tr>
<td><strong>Space:</strong> <code>29</code></td>
<td><strong>Space:</strong> <code>29</code></td>
</tr>
<tr>
<td><strong>Sports:</strong> <code>30</code></td>
<td><strong>Sports:</strong> <code>30</code></td>
</tr>
<tr>
<td><strong>Super Power:</strong> <code>31</code></td>
<td><strong>Super Power:</strong> <code>31</code></td>
</tr>
<tr>
<td><strong>Vampire:</strong> <code>32</code></td>
<td><strong>Vampire:</strong> <code>32</code></td>
</tr>
<tr>
<td><strong>Yaoi:</strong> <code>33</code></td>
<td><strong>Yaoi:</strong> <code>33</code></td>
</tr>
<tr>
<td><strong>Yuri:</strong> <code>34</code></td>
<td><strong>Yuri:</strong> <code>34</code></td>
</tr>
<tr>
<td><strong>Harem:</strong> <code>35</code></td>
<td><strong>Harem:</strong> <code>35</code></td>
</tr>
<tr>
<td><strong>Slice Of Life:</strong> <code>36</code></td>
<td><strong>Slice Of Life:</strong> <code>36</code></td>
</tr>
<tr>
<td><strong>Supernatural:</strong> <code>37</code></td>
<td><strong>Supernatural:</strong> <code>37</code></td>
</tr>
<tr>
<td><strong>Military:</strong> <code>38</code></td>
<td><strong>Military:</strong> <code>38</code></td>
</tr>
<tr>
<td><strong>Police:</strong> <code>39</code></td>
<td><strong>Police:</strong> <code>39</code></td>
</tr>
<tr>
<td><strong>Psychological:</strong> <code>40</code></td>
<td><strong>Psychological:</strong> <code>40</code></td>
</tr>
<tr>
<td><strong>Thriller:</strong> <code>41</code></td>
<td><strong>Seinen:</strong> <code>41</code></td>
</tr>
<tr>
<td><strong>Seinen:</strong> <code>42</code></td>
<td><strong>Josei:</strong> <code>42</code></td>
</tr>
<tr>
<td><strong>Josei:</strong> <code>43</code></td>
<td><strong>Doujinshi:</strong> <code>43</code></td>
</tr>
<tr>
<td></td>
<td><strong>Gender Bender:</strong> <code>44</code></td>
</tr>
<tr>
<td></td>
<td><strong>Thriller:</strong> <code>45</code></td>
</tr>
</tbody>
</table>
<h4>Examples</h4>
<p><code>/search/manga/Grand%20Blue/1</code> <strong>(DEPRECIATED v3+)</strong></p>
<p><code>/search/manga?q=Grand%20Blue&page=1</code> <strong>(RECOMMENDED)</strong></p>
<p>The first way won’t work due to the back slash in “Fate/Zero”. It’s encouraged to use the the GET method below for all queries since it responds more accurately for UTF8 characters and percentage encoding.</p>
<p><code>/search/anime?q=Fate/Zero&page=1</code></p>
<p>Furthermore, the former method is <strong>depreciated</strong> in v3+. Use <code>q</code> for passing queries.</p>
<p><code>/search/people/?q=Sawashiro&limit=3</code></p> </div>

<div><div>

<div>
<a href="/reference/0/search/search-request-example+schema">
<div></div>

  <h4>
    Search Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Season  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Anime of the specified season</p>

<p><strong>Note:</strong> Both parameters are required.</p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>year</td>
<td>Integer: Year</td>
<td>Specify the year</td>
</tr>
<tr>
<td>season</td>
<td><code>summer</code> <code>spring</code> <code>fall</code> <code>winter</code></td>
<td>Specify the season</td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/season/season-request-example+schema">
<div></div>

  <h4>
    Season Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Season Archive  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>All the years &amp; their respective seasons that can be parsed from MyAnimeList</p>    </div>

<div><div>

<div>
<a href="/reference/0/season-archive/season-archive-request-example+schema">
<div></div>

  <h4>
    Season Archive Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Season Later  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Anime that have been announced for the upcoming seasons</p>    </div>

<div><div>

<div>
<a href="/reference/0/season-later/season-later-request-example+schema">
<div></div>

  <h4>
    Season Later Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Schedule  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Anime schedule of the week or specified day</p>

<p><strong>Note:</strong> If you don’t pass the <code>day</code> parameter, it’ll return the schedule for <strong>all</strong> days of the week</p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>day (optional)</td>
<td><code>monday</code> <code>tuesday</code> <code>wednesday</code> <code>thursday</code> <code>friday</code> <code>saturday</code> <code>sunday</code>, <code>other</code> <strong>(v3)</strong>, <code>unknown</code> <strong>(v3)</strong></td>
<td>Anime scheduled for that specific day</td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/schedule/schedule-request-example+schema">
<div></div>

  <h4>
    Schedule Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Top  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Top items on MyAnimeList</p>

<p><strong>Note:</strong> <code>subtype</code> returns a filtered top list of a type <code>type</code> item. For example, the top Anime (type) movies (subtype)
<strong>Note 2:</strong> <code>subtype</code> is only for <code>anime</code> and <code>manga</code> types.
<strong>Note 3:</strong> Date properties are returned in string as they only consist of the month and year - which is not appropriate for ISO8601</p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td><code>anime</code> <code>manga</code>, <code>people</code> (v3+), <code>characters</code> (v3+)</td>
<td>Top items of this type</td>
</tr>
<tr>
<td>page (optional)</td>
<td>INTEGER</td>
<td>The Top page on MyAnimeList is paginated offers 50 items per page</td>
</tr>
<tr>
<td>subtype (optional)</td>
<td><strong>Anime:</strong> <code>airing</code> <code>upcoming</code> <code>tv</code> <code>movie</code> <code>ova</code> <code>special</code> <strong>Manga:</strong> <code>manga</code> <code>novels</code> <code>oneshots</code> <code>doujin</code> <code>manhwa</code> <code>manhua</code> <strong>Both:</strong> <code>bypopularity</code> <code>favorite</code></td>
<td></td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/top/top-request-example+schema">
<div></div>

  <h4>
    Top Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Genre  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Anime/Manga items of the genre</p>

<p><strong>Note:</strong> Genres with their respective IDs are listed <a href>here</a></p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>type</td>
<td><code>anime</code> <code>manga</code></td>
<td>Genre of this type</td>
</tr>
<tr>
<td>genre_id</td>
<td>INTEGER</td>
<td>Genre ID from MyAnimeList - <a href>Genre Mapping</a></td>
</tr>
<tr>
<td>page (optional)</td>
<td></td>
<td></td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/genre/genre-request-example+schema">
<div></div>

  <h4>
    Genre Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Producer  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Anime by this Producer/Studio/Licensor</p>

<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>producer_id</td>
<td>INTEGER</td>
<td>Producer ID from MyAnimeList</td>
</tr>
<tr>
<td>page (optional)</td>
<td></td>
<td></td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/producer/producer-request-example+schema">
<div></div>

  <h4>
    Producer Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Magazine  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Manga by this Magazine/Serializer/Publisher</p>

<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>magazine_id</td>
<td>INTEGER</td>
<td>Magazine ID from MyAnimeList</td>
</tr>
<tr>
<td>page (optional)</td>
<td></td>
<td></td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/magazine/magazine-request-example+schema">
<div></div>

  <h4>
    Magazine Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

User  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>User related data</p>

<p><strong>Note:</strong> About is returned in HTML as MyAnimeList allows custom “about” sections for users that can consist of images, formatting, etc.</p>
<p><strong>Note 2:</strong> Anime & Manga Lists are paginated. Only 300 items are returned per page.</p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>username</td>
<td>string</td>
<td>Username on MyAnimeList</td>
</tr>
<tr>
<td>request</td>
<td><code>profile</code>, <code>history</code>, <code>friends</code>, <code>animelist</code>, <code>mangalist</code></td>
<td></td>
</tr>
<tr>
<td>data (optional)</td>
<td>Additional data for the requests</td>
<td></td>
</tr>
</tbody>
</table>
<h4>Data</h4>
<table>
<thead>
<tr>
<th>Data</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>history</td>
<td><code>anime</code>, <code>manga</code></td>
<td>Returns both combined if neither are passed</td>
</tr>
<tr>
<td>friends</td>
<td>INTEGER</td>
<td>Pagination support; Status 404 if there’s no friends on the page</td>
</tr>
<tr>
<td>animelist</td>
<td><strong>See Enums Below</strong></td>
<td></td>
</tr>
<tr>
<td>mangalist</td>
<td><strong>See Enums Below</strong></td>
<td></td>
</tr>
</tbody>
</table>
<h4>User List Filter</h4>
<table>
<thead>
<tr>
<th>Anime List <code>/animelist</code></th>
<th>Manga List <code>/mangalist</code></th>
</tr>
</thead>
<tbody>
<tr>
<td><code>/</code></td>
<td><code>/</code></td>
</tr>
<tr>
<td><code>/all</code> (alias)</td>
<td><code>/all</code> (alias)</td>
</tr>
<tr>
<td><code>/watching</code></td>
<td><code>/reading</code></td>
</tr>
<tr>
<td><code>/completed</code></td>
<td><code>/completed</code></td>
</tr>
<tr>
<td><code>/onhold</code></td>
<td><code>/onhold</code></td>
</tr>
<tr>
<td><code>/dropped</code></td>
<td><code>/dropped</code></td>
</tr>
<tr>
<td><code>/plantowatch</code></td>
<td><code>/plantoread</code></td>
</tr>
<tr>
<td><code>/ptw</code> (alias)</td>
<td><code>/ptr</code></td>
</tr>
</tbody>
</table>
<h3>Advanced User List Parameters (Anime & Manga)</h3>
<p><strong>Note:</strong> These are search filters which have to be passed as GET <code>key=value</code></p>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>search</code></td>
<td>STRING</td>
<td>Return items in your list matching the string</td>
</tr>
<tr>
<td><code>q</code> (alias)</td>
<td>STRING</td>
<td>Return items in your list matching the string</td>
</tr>
<tr>
<td><code>page</code> (alias)</td>
<td>INEGER</td>
<td>Pass page number as a <code>key=value</code></td>
</tr>
<tr>
<td><code>sort</code></td>
<td><strong>See Enums Below</strong></td>
<td>Sort <code>order_by</code> (Default is <code>descending</code>)</td>
</tr>
</tbody>
</table>
<h3>Advanced User List Parameters (ANIME)</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>order_by</code></td>
<td><strong>See Enums Below</strong></td>
<td>Order items with respect to a property</td>
</tr>
<tr>
<td><code>order_by2</code></td>
<td><strong>See Enums Below</strong></td>
<td>Order items with respect to a second property</td>
</tr>
<tr>
<td><code>aired_from</code></td>
<td><code>yyyy-mm-dd</code></td>
<td>Filter Anime that have aired from this date</td>
</tr>
<tr>
<td><code>aired_to</code></td>
<td><code>yyyy-mm-dd</code></td>
<td>Filter Anime that have aired till this date</td>
</tr>
<tr>
<td><code>producer</code></td>
<td>Integer</td>
<td>Filter Anime by this Producer ID</td>
</tr>
<tr>
<td><code>year</code></td>
<td>Integer: Year</td>
<td>Filter anime from a year</td>
</tr>
<tr>
<td><code>season</code></td>
<td><code>summer</code> <code>spring</code> <code>fall</code> <code>winter</code></td>
<td>Filter anime from a season (require <code>year</code>)</td>
</tr>
<tr>
<td><code>airing_status</code></td>
<td><strong>See Enums Below</strong></td>
<td>Filter Anime with a status</td>
</tr>
</tbody>
</table>
<h3>Advanced User List Parameters (MANGA)</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>order_by</code></td>
<td><strong>See Enums Below</strong></td>
<td>Order items with respect to a property</td>
</tr>
<tr>
<td><code>order_by2</code></td>
<td><strong>See Enums Below</strong></td>
<td>Order items with respect to a second property</td>
</tr>
<tr>
<td><code>published_from</code></td>
<td><code>yyyy-mm-dd</code></td>
<td>Filter Manga that have published from this date</td>
</tr>
<tr>
<td><code>published_to</code></td>
<td><code>yyyy-mm-dd</code></td>
<td>Filter Manga that have published till this date</td>
</tr>
<tr>
<td><code>magazine</code></td>
<td>Integer</td>
<td>Filter Manga by this Magazine ID</td>
</tr>
<tr>
<td><code>publishing_status</code></td>
<td><strong>See Enums Below</strong></td>
<td>Filter Manga with a status</td>
</tr>
</tbody>
</table>
<p>Regarding <code>yyyy-mm-dd</code> dates, you can search for only the year or only the year and the month as well.
Just pass it as <code>yyyy-00-00</code> or <code>yyyy-mm-00</code>. e.g <code>2018-00-00</code>, <code>2018-12-00</code></p>
<h4>Enums</h4>
<h5><code>order_by</code> & <code>order_by2</code></h5>
<table>
<thead>
<tr>
<th>Anime List</th>
<th>Manga List</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>title</code></td>
<td><code>title</code></td>
</tr>
<tr>
<td><code>finish_date</code></td>
<td><code>finish_date</code></td>
</tr>
<tr>
<td><code>start_date</code></td>
<td><code>start_date</code></td>
</tr>
<tr>
<td><code>score</code></td>
<td><code>score</code></td>
</tr>
<tr>
<td><code>last_updated</code></td>
<td><code>last_updated</code></td>
</tr>
<tr>
<td><code>type</code></td>
<td><code>type</code></td>
</tr>
<tr>
<td><code>rated</code></td>
<td></td> </tr> <tr> <td><code>rewatch</code></td> <td></td>
</tr>
<tr>
<td><code>rewatch_value</code> (alias)</td>
<td></td> </tr> <tr> <td><code>priority</code></td> <td><code>priority</code></td> </tr> <tr> <td><code>progress</code></td> <td><code>progress</code> (<code>chapters_read</code>)</td> </tr> <tr> <td><code>episodes_watched</code> (alias)</td> <td><code>chapters_read</code> (alias)</td> </tr> <tr> <td></td> <td><code>volumes_read</code></td> </tr> <tr> <td><code>storage</code></td> <td></td>
</tr>
<tr>
<td><code>air_start</code></td>
<td><code>publish_start</code></td>
</tr>
<tr>
<td><code>air_end</code></td>
<td><code>publish_end</code></td>
</tr>
<tr>
<td><code>status</code></td>
<td><code>status</code></td>
</tr>
</tbody>
</table>
<h5><code>sort</code></h5>
<table>
<thead>
<tr>
<th>Anime & Manga Sort</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ascending</code></td>
</tr>
<tr>
<td><code>asc</code> (alias)</td>
</tr>
<tr>
<td><code>descending</code></td>
</tr>
<tr>
<td><code>desc</code> (alias)</td>
</tr>
</tbody>
</table>
<h5><code>airing_status</code> & <code>publishing_status</code></h5>
<table>
<thead>
<tr>
<th>Anime Airing Status</th>
<th>Manga Publishing Status</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>airing</code></td>
<td><code>publishing</code></td>
</tr>
<tr>
<td><code>finished</code></td>
<td><code>finished</code></td>
</tr>
<tr>
<td><code>complete</code> (alias)</td>
<td><code>complete</code> (alias)</td>
</tr>
<tr>
<td><code>to_be_aired</code></td>
<td><code>to_be_published</code></td>
</tr>
<tr>
<td><code>not_yet_aired</code> (alias)</td>
<td><code>not_yet_published</code> (alias)</td>
</tr>
<tr>
<td><code>tba</code> (alias)</td>
<td><code>tbp</code> (alias)</td>
</tr>
<tr>
<td><code>nya</code> (alias)</td>
<td><code>nyp</code> (alias)</td>
</tr>
</tbody>
</table>
<h4>Examples</h4>
<p><code>/user/nekomata1037</code> - Parses Profile</p>
<p><code>/user/nekomata1037/profile</code> (alias)</p>
<p><code>/user/nekomata1037/history</code> - Parses user history (anime+manga)</p>
<p><code>/user/nekomata1037/history/anime</code> - Parses user history (anime only)</p>
<p><code>/user/nekomata1037/friends</code> - Parses user friends</p>
<p>The request below will return 404 because I don’t have that many friends on MAL to generate a second page.
<code>/user/nekomata1037/friends/2</code> - Parses user friends (from page 2)</p>
<p><strong>Anime & Manga Lists</strong></p>
<p>Lists are paginated (300 items per page).</p>
<p><code>/user/nekomata1037/animelist/all</code> - All anime in user list</p>
<p><code>/user/nekomata1037/animelist/all/2</code> - Page 2</p>
<p><code>/user/nekomata1037/mangalist/reading</code> - Manga that I’m currently reading</p> </div>

<div><div>

<div>
<a href="/reference/0/user/user-request-example+schema">
<div></div>

  <h4>
    User Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Club  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>A single club object with all its details</p>

<h3>Requests</h3>
<table>
<thead>
<tr>
<th>Request</th>
<th>Parameter</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>members</td>
<td>Page (INTEGER)</td>
<td>Fetches list of club members</td>
</tr>
</tbody>
</table>
<h3>Example Calls</h3>
<ul>
<li>
<p><code>/club/1</code> // Returns club information</p>
</li>
<li>
<p><code>/club/1/members/1</code> // Returns list of club members</p>
</li>
</ul>
<h4>Remarks</h4>
<ul>
<li>Only 35 items are shown per page for members</li>
</ul> </div>

<div><div>

<div>
<a href="/reference/0/club/club-request-example+schema">
<div></div>

  <h4>
    Club Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div><div>

Meta  

<div></div>

<div>
<div>
<h3>Attributes</h3>
</div>

<div></div>
<div></div>

</div>

  <div>
  <p>Requests related to meta information regarding the Jikan REST Instance.

Such as the most requested endpoints for a specific period, or just status on the REST API.</p>
<h3>Parameters</h3>
<table>
<thead>
<tr>
<th>Parameter</th>
<th>Argument</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>request</td>
<td><code>requests</code> <code>status</code></td>
<td></td>
</tr>
<tr>
<td>type</td>
<td><code>anime</code> <code>manga</code> <code>character</code> <code>person</code> <code>search</code> <code>top</code> <code>schedule</code> <code>season</code></td>
<td>This is only for the <code>requests</code> endpoint</td>
</tr>
<tr>
<td>period</td>
<td><code>today</code> <code>weekly</code> <code>monthly</code></td>
<td>This is only for the <code>requests</code> endpoint</td>
</tr>
<tr>
<td>offset</td>
<td>int</td>
<td>1,000 requests are shown per page, you can use the offset to show more</td>
</tr>
</tbody>
</table> </div>

<div><div>

<div>
<a href="/reference/0/meta/meta-request-example+schema">
<div></div>

  <h4>
    Meta Request Example+Schema      </h4>
  

  
  <div></div>
  

      </a>
  </div>

<div></div>

</div></div>

</div></div>

</div></div></div></div>
<div></div>
<div></div>

</div></div>

Followers: 65
API Creator:
Rapid account: API Guy
API Guy
theapiguy
Log In to Rate API
Rating: 4.7 - Votes: 3