Anime API

Disclaimer

This api does not store any files , it only link to the media which is hosted on 3rd party services.
This api is explicitly made for educational purposes only and not for commercial usage. This repo will not be responsible for any misuse of it.

Anime API

RestFul API made with Node.js
(Checkout this anime streaming website Zenime powered by this API)

Table of Contents

Installation

Local installation

Make sure you have node installed on your device

Run the following code to clone the repository and install all required dependencies

$ git clone https://github.com/itzzzme/anime-api.git
$ cd anime-api
$ npm install

Refer the .env.example file to setup .env file

# Origins you want to allow

ALLOWED_ORIGIN=<https://site1.com>,<https://site2.com>,...

Start the server

$ npm start #or npm run devStart

Deployment

Vercel

Host your own instance of anime-api on vercel

Render

Host your own instance of anime-api on Render.

Documentation

`GET` Home info

  GET /api/

Endpoint

  /api/

No parameter required ❌

Example of request

import axios from "axios";
const resp = await axios.get("/api/");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "spotlights": [
      {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "description": string,
        "tvInfo": {
          "showType": string,
          "duration": string,
          "releaseDate": string,
          "quality": string,
          "episodeInfo": [object]
        }
      },
      {...}
    ],
    "trending": [
      {
        "id":string,
        "data_id": number,
        "number": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
      }
      {...}
    ],
    "today":[
      "schedule":[
        {
          "id":string,
          "data_id":number,
          "title":string,
          "japanese_title":string,
          "releaseDate":string,
          "time":string,
          "episode_no":number,
        },{...}
      ]
    ],
    "topAiring":[
      {
        "id":string,
        "data_id":number,
        "poster":string,
        "title":string,
        "japanese_title":string,
        "description":string,
        tvInfo:[object]
      }
    ],
    "mostPopular":[
      {
        "id":string,
        "data_id":number,
        "poster":string,
        "title":string,
        "japanese_title":string,
        "description":string,
        tvInfo:[object]
      },
    "mostFavorite":[
      {
        "id":string,
        "data_id":number,
        "poster":string,
        "title":string,
        "japanese_title":string,
        "description":string,
        tvInfo:[object]
      }
    ],
    "latestCompleted":[
      {
        "id":string,
        "data_id":number,
        "poster":string,
        "title":string,
        "japanese_title":string,
        "description":string,
        tvInfo:[object]
      }
    ],
    "latestEpisode":[
      {
        "id":string,
        "data_id":number,
        "poster":string,
        "title":string,
        "japanese_title":string,
        "description":string,
        tvInfo:[object]
      }
    ],
    "genres":[
      string,
      string,
      string,
      ...
    ]
  }
}

`GET` Top 10 anime's info

  GET /api/top-ten

Endpoint

  /api/top-ten

No parameter required ❌

Example of request

import axios from "axios";
const resp = await axios.get("/api/top-ten");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    "topTen":[
      "today":[
        {
          "id":string,
          "data_id": number,
          "number": number,
          "name": string,
          "poster": string,
          "tvInfo": [Object]
        },
        {...}
      ],
      "week":[
        {
          "id":string,
          "data_id": number,
          "number": number,
          "name": string,
          "poster": string,
          "tvInfo": [Object]
        },
        {...}
      ],
      "month":[
        {
          "id":string,
          "data_id": number,
          "number": number,
          "name": string,
          "poster": string,
          "tvInfo": [Object]
        },
        {...}
      ],
    ]
  ]
}

`GET` Top Search

  GET /api/top-search

No parameter required ❌

Example of request

import axios from "axios";
const resp = await axios.get("/api/top-search");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    {
      "title": string,
      "link": string
    },
    {...}
  ]
}

`GET` Specified anime's info

  GET /api/info

Endpoint

  /api/info?id={string}

Parameters

Parameter	Parameter-Type	Data-Type	Description	Mandatory ?	Default
`id`	`query`	string	anime-id	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/info?id=yami-shibai-9-17879");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "data": {
      "adultContent":boolean,
      "id":string,
      "data_id": number,
      "title": string,
      "japanese_title": string,
      "poster": string,
      "showType":string,
      "animeInfo": {
        "Overview": string,
        "Japanese": string,
        "Synonyms": string,
        "Aired": string,
        "Premiered": string,
        "Duration": string,
        "Status": string,
        "MAL Score": string,
        "Genres": [Object],
        "Studios": string,
        "Producers": [Object]
      }
    },
    "seasons": [
      {
        "id":string,
        "data_number": number,
        "data_id": number,
        "season": string,
        "title": string,
        "japanese_title": string,
        "season_poster": string
      },
      {...}
    ],

  }
}

`GET` Random anime's info

  GET /api/random

Endpoint

  /api/random

Example of request

import axios from "axios";
const resp = await axios.get("/api/random");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "data": {
      "adultContent":boolean,
      "id":string,
      "data_id": number,
      "title": string,
      "japanese_title": string,
      "poster": string,
      "showType":string,
      "animeInfo": {
        "Overview": string,
        "Japanese": string,
        "Synonyms": string,
        "Aired": string,
        "Premiered": string,
        "Duration": string,
        "Status": string,
        "MAL Score": string,
        "Genres": [Object],
        "Studios": string,
        "Producers": [Object]
      }
    },
    "related_data":[
      [
       {
          "duration": "string",
          "data_id": "number",
          "id": "string",
          "title": "string",
          "japanese_title": "string",
          "poster": "string",
          "tvInfo": {
              "dub": "number",
              "sub": "number",
              "showType": "string",
              "eps": "number"
            }
        },{...}
      ]
    ],
    "recommended_data":[
      [
       {
          "duration": "string",
          "data_id": "number",
          "id": "string",
          "title": "string",
          "japanese_title": "string",
          "poster": "string",
          "tvInfo": {
              "dub": "number",
              "sub": "number",
              "showType": "string",
              "eps": "number"
            }
        },{...}
      ]
    ],
    "seasons": [
      {
        "id":string,
        "data_number": number,
        "data_id": number,
        "season": string,
        "title": string,
        "japanese_title": string,
        "season_poster": string
      },
      {...}
    ],

  }
}

`GET` Categories info

  GET /api/<category>

Endpoint

  /api/{string}?page={number}
  #or
  /api/{string}

Parameters

Parameter	Parameter-Type	Data-Type	Description	Mandatory ?	Default
`category`	`path`	`string`	`Category`	Yes ✔️	--
`page`	`query`	`number`	`Page-no.`	No ❌	`1`

Example of request

import axios from "axios";
const resp = await axios.get("/api/most-popular?page=1");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "totalPages": number,
    "data": [
      {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "description": string,
        "tvInfo": {
          "showType": string,
          "duration": string,
          "sub": number,
          "dub": number
        },
        "adultContent":boolean,
      },
      {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "description": string,
        "tvInfo": {
          "showType": sting,
          "duration": string,
          "sub": number,
          "dub": number,
          "eps": number
        },
        "adultContent":boolean,
      },
      {...}
    ],
    "totalPages":number
  }
}

`GET` Anime of specific producers or studio

  GET /api/<producer>/

Endpoint

  /api/producer/{string}?page={number}
  #or
  /api/producer/{string}

Parameters

Parameter	Parameter-Type	Data-Type	Description	Mandatory ?	Default
`producer`	`path`	`string`	`Producer`	Yes ✔️	--
`page`	`query`	`number`	`Page-no.`	No ❌	`1`

Example of request

import axios from "axios";
const resp = await axios.get("/api/producer/ufotable?page=1");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "totalPages": number,
    "data": [
      {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "description": string,
        "tvInfo": {
          "showType": string,
          "duration": string,
          "sub": number,
          "dub": number
        },
        "adultContent":boolean,
      },
      {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "description": string,
        "tvInfo": {
          "showType": sting,
          "duration": string,
          "sub": number,
          "dub": number,
          "eps": number
        },
        "adultContent":boolean,
      },
      {...}
    ],
    "totalPages":number
  }
}

`GET` Search result's info

  GET /api/search

Endpoint

  /api/search?keyword={string}

Parameters

Parameter	Parameter-Type	Type	Description	Mandatory ?	Default
`keyword`	`query`	`string`	`keyword`	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/search?keyword=one%20punch%20man");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "tvInfo": [Object]
      },
    {
        "id":string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "tvInfo": [Object]
      },
    {...}
  ]
}

`GET` Search suggestions

  GET /api/search/suggest

Endpoint

  /api/search/suggest?keyword={string}

Parameters

Parameter	Parameter-Type	Type	Description	Mandatory ?	Default
`keyword`	`query`	`string`	`keyword`	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/search/suggest?keyword=demon");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    {
        "id":"string",
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "releaseDate": string,
        "showType": string,
        "duration": string,
      },
    {
        "id":"string",
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "releaseDate": string,
        "showType": string,
        "duration": string,
      },
    {...}
  ]
}

`GET` Filter Anime

GET /api/filter

Endpoint

/api/filter

Parameters

Parameter	Parameter-Type	Data-Type	Description	Mandatory ?	Default
`type`	`query`	string	Type of anime (e.g., `movie`, `tv`, etc.)	No ❌	`ALL`
`status`	`query`	string	Status of anime (e.g., `finished`, `currently_airing`, etc.)	No ❌	`ALL`
`rated`	`query`	string	Rating of anime (e.g., `G`, `PG`, etc.)	No ❌	`ALL`
`score`	`query`	string	Score rating (e.g., `1` to `10`)	No ❌	`ALL`
`season`	`query`	string	Season of anime (e.g., `spring`, `summer`, etc.)	No ❌	`ALL`
`language`	`query`	string	Language of anime (e.g., `sub`, `dub`)	No ❌	`ALL`
`genres`	`query`	string	Comma-separated list of genres (e.g., `action, comedy`)	No ❌	`ALL`
`sort`	`query`	string	Sorting method (e.g., `default`, `score`, etc.)	No ❌	`DEFAULT`
`page`	`query`	number	Page number for pagination	No ❌	`1`
`sy`	`query`	number	Start year	No ❌	`undefined`
`sm`	`query`	number	Start month	No ❌	`undefined`
`sd`	`query`	number	Start day	No ❌	`undefined`
`ey`	`query`	number	End year	No ❌	`undefined`
`em`	`query`	number	End month	No ❌	`undefined`
`ed`	`query`	number	End day	No ❌	`undefined`
`keyword`	`query`	string	Search keyword	No ❌	`undefined`

Example of Request

import axios from "axios";

const params = {
  type: "2", // TV
  status: "1", // Finished
  rated: "5", // R+
  sort: "default",
  page: 1,
};

const resp = await axios.get("/api/filter", { params });
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "totalPages": number,
    "data": [
      {
        "id": string,
        "data_id": number,
        "poster": string,
        "title": string,
        "japanese_title": string,
        "description": string,
        "tvInfo": {
          "showType": string,
          "duration": string,
          "sub": number,
          "dub": number
        },
        "adultContent": boolean
      },
      {...}
    ]
  }
}

`GET` Anime's episode list

  GET /api/episodes/

Endpoint

  /api/episodes/{param}

Parameters

Parameter-Type	Data-Type	Description	Mandatory ?	Default
`param`	string	anime-id	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/episodes/one-piece-100");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    "totalEpisodes":number,
    "episodes":[
    { "episode_no": number,
      "id": string,
      "data_id": number,
      "jname": string,
      "title": string,
      "japanese_title": string
    },
    {...}
    ]
  ]
}

`GET` Schedule of upcoming anime

  GET /api/schedule

Endpoint

  /api/schedule?date={string}

Parameters

Parameter	Parameter-Type	Data-Type	Description	Mandatory ?	Default
`date`	query	string	date	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/schedule?date=2024-09-23");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    {
      "id":string,
      "data_id":number,
      "title":string,
      "japanese_title":string,
      "releaseDate":string,
      "time":string,
      "episode_no":number
    },
    {...}
  ]
}

`GET` Schedule of next episode of Anime

  GET /api/schedule/

Endpoint

  /api/schedule/:id

Parameters

Parameter	Parameter-Type	Data-Type	Description	Mandatory ?	Default
`id`	param	string	anime-id	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/schedule/one-piece-100");
console.log(resp.data);

Sample Response

{
  "success":true,
  "results":
  {
    "nextEpisodeSchedule":"2025-02-08 16:30:00"
  }
}

`GET` Qtip info

   GET /api/qtip/

Endpoint

   /api/qtip/{id}

Parameters

Parameter	Data-Type	Description	Mandatory ?	Default
`param`	`number`	id	Yes ✔️	Yes ✔️

Example of request

import axios from "axios";
const resp = await axios.get("/api/qtip/3365");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "title": string,
    "rating": double,
    "quality": string,
    "subCount": number,
    "dubCount": number,
    "episodeCount": number,
    "type": string,
    "description": string,
    "japaneseTitle": string,
    "Synonyms": string,
    "airedDate": string,
    "status": string,
    "genres": [Object],
    "watchLink": string
  }
}

`GET` Characters

   GET /api/character/list/

Endpoint

   /api/character/list/{id}

Parameters

Parameter-Type	Data-Type	Description	Mandatory ?	Default
`param`	`string`	anime-id	Yes ✔️	Yes ✔️

Example of request

import axios from "axios";
const resp = await axios.get("/api/character/list/one-piece-100");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "currentPage": number,
    "totalPages": number,
    "data": [
      {
        "character": {
          "id": string,
          "poster": string,
          "name": string,
          "cast": string
        },
        "voiceActors": [
          {
            "id": string,
            "poster": string,
            "name": string
          },
          {
            "id": string,
            "poster": string,
            "name": string
          },
          {...}
        ]
      },{...}
    ]
  }
}

`GET` Streaming info

  GET /api/stream

Endpoint

  /api/stream?id={string}&server={string}&type={string}

Parameters

Parameters	Parameter-Type	Type	Mandatory ?	Default
`id` , `server` , `type`	`query`	`string`	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get(
  "/api/stream?id=frieren-beyond-journeys-end-18542?ep=107257&server=hd-1&type=sub"
);
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "streamingLink": [
      {
            "id":number,
            "type": "sub",
            "link": {
              "file":string,
              "type":string,
            },
            "tracks": [
              {
                "file": string,
                "label": string,
                "kind": string,
                "default": boolean
              },{...}
            ],
            "intro": [Object],
            "outro": [Object],
            "server":string
      }
    ],
    "servers": [
      {
        "type":string,
        "data_id": number,
        "server_id": number,
        "server_name": string
      },
      {...}
    ]
  }
}

`GET` Fallback Streaming info

  GET /api/stream/fallback

Endpoint

  /api/stream/fallback?id={string}&server={string}&type={string}

Parameters

Parameters	Parameter-Type	Type	Mandatory ?	Default
`id` , `server` , `type`	`query`	`string`	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get(
  "/api/stream/fallback?id=frieren-beyond-journeys-end-18542?ep=107257&server=hd-1&type=sub"
);
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "streamingLink": [
      {
            "id":number,
            "type": "sub",
            "link": {
              "file":string,
              "type":string,
            },
            "tracks": [
              {
                "file": string,
                "label": string,
                "kind": string,
                "default": boolean
              },{...}
            ],
            "intro": [Object],
            "outro": [Object],
            "server":string
      }
    ],
    "servers": [
      {
        "type":string,
        "data_id": number,
        "server_id": number,
        "server_name": string
      },
      {...}
    ]
  }
}

`GET` Available servers of anime

  GET /api/servers/

Endpoint

  /api/servers/{id}

Parameters

Parameter-Type	Data-Type	Description	Mandatory ?	Default
`params`	`string`	`keyword`	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get(
  "/api/servers/demon-slayer-kimetsu-no-yaiba-hashira-training-arc-19107?ep=124260"
);
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": [
    {
      "type": string,
      "data_id": number,
      "server_id": number,
      "serverName": string
    },
    {...},
  ]
}

`GET` Character Details

  GET /api/character/

Endpoint

  /api/character/{id}

Parameters

Parameter-Type	Data-Type	Description	Mandatory ?	Default
`params`	`string`	character-id	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/character/asta-340");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "data": [{
      "id": "asta-340",
      "name": "Asta",
      "profile": "https://cdn.noitatnemucod.net/thumbnail/400x400/100/945515d313d02fdcd33be3085512c550.jpg",
      "japaneseName": "アスタ",
      "about": {
        "description": "Asta is the main protagonist of Black Clover...",
        "style": "<p>Asta is the main protagonist of Black Clover...</p>"
      },
      "voiceActors": [
        {
          "name": "Kajiwara, Gakuto",
          "profile": "https://example.com/profile.jpg",
          "language": "Japanese",
          "id": "gakuto-kajiwara-534"
        },
        {
          "name": "Dallas Reid",
          "profile": "https://example.com/profile2.jpg",
          "language": "English",
          "id": "dallas-reid-892"
        }
      ],
      "animeography": [
        {
          "title": "Black Clover",
          "id": "2404",
          "role": "Main",
          "type": "TV",
          "poster": "https://example.com/poster.jpg"
        },
        {
          "title": "Black Clover: Sword of the Wizard King",
          "id": "2405",
          "role": "Main",
          "type": "Movie",
          "poster": "https://example.com/poster2.jpg"
        }
      ]
    }]
  }
}

`GET` Voice Actor Details

  GET /api/actors/

Endpoint

  /api/actors/{id}

Parameters

Parameter-Type	Data-Type	Description	Mandatory ?	Default
`params`	`string`	voice-actor-id	Yes ✔️	--

Example of request

import axios from "axios";
const resp = await axios.get("/api/actors/gakuto-kajiwara-534");
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "data": [{
      "id": "gakuto-kajiwara-534",
      "name": "Kajiwara, Gakuto",
      "profile": "https://cdn.noitatnemucod.net/thumbnail/400x400/100/945515d313d02fdcd33be3085512c550.jpg",
      "japaneseName": "梶原岳人",
      "about": {
        "description": "Kajiwara Gakuto is a Japanese voice actor...",
        "style": "<p>Kajiwara Gakuto is a Japanese voice actor...</p>"
      },
      "roles": [
        {
          "anime": {
            "title": "Black Clover",
            "poster": "https://example.com/poster.jpg",
            "type": "TV",
            "year": "2017",
            "id": "black-clover"
          },
          "character": {
            "name": "Asta",
            "profile": "https://example.com/asta.jpg",
            "role": "Main"
          }
        },
        // ... more roles ...
      ]
    }]
  }
}

Pull Requests

Pull requests are welcomed that address bug fixes, improvements, or new features.
Fork the repository and create a new branch for your changes.
Ensure your code follows our coding standards.
Include tests if applicable.
Describe your changes clearly in the pull request, explaining the problem and solution.

Reporting Issues

If you discover any issues or have suggestions for improvement, please open an issue. Provide a clear and concise description of the problem, steps to reproduce it, and any relevant information about your environment.

Support

If you like the project feel free to drop a star ✨. Your appreciation means a lot.

Made by itzzzme 🫰

Name		Name	Last commit message	Last commit date
Latest commit History 297 Commits
.github		.github
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
package.json		package.json
render.yaml		render.yaml
server.js		server.js
vercel.json		vercel.json

Uh oh!

License

Uh oh!

itzzzme/anime-api

Folders and files

Latest commit

History

Repository files navigation

Disclaimer

Anime API

Table of Contents

Installation

Local installation

Deployment

Vercel

Render

Documentation

GET Home info

Endpoint

No parameter required ❌

Example of request

Sample Response

GET Top 10 anime's info

Endpoint

No parameter required ❌

Example of request

Sample Response

GET Top Search

No parameter required ❌

Example of request

Sample Response

GET Specified anime's info

Endpoint

Parameters

Example of request

Sample Response

GET Random anime's info

Endpoint

Example of request

Sample Response

GET Categories info

Endpoint

Parameters

List of Categories

Example of request

Sample Response

GET Anime of specific producers or studio

Endpoint

Parameters

Example of request

Sample Response

GET Search result's info

Endpoint

Parameters

Example of request

Sample Response

GET Search suggestions

Endpoint

Parameters

Example of request

Sample Response

GET Filter Anime

Endpoint

Parameters

Example of Request

Sample Response

GET Anime's episode list

Endpoint

Parameters

Example of request

Sample Response

GET Schedule of upcoming anime

Endpoint

Parameters

Example of request

Sample Response

GET Schedule of next episode of Anime

Endpoint

Parameters

Example of request

`GET` Home info

`GET` Top 10 anime's info

`GET` Top Search

`GET` Specified anime's info

`GET` Random anime's info

`GET` Categories info

`GET` Anime of specific producers or studio

`GET` Search result's info

`GET` Search suggestions

`GET` Filter Anime

`GET` Anime's episode list

`GET` Schedule of upcoming anime

`GET` Schedule of next episode of Anime

`GET` Qtip info

`GET` Characters

`GET` Streaming info

`GET` Fallback Streaming info

`GET` Available servers of anime

`GET` Character Details

`GET` Voice Actor Details