Anime API

API made with Node.js ( scrape data from hianime.to)

! Disclaimer !

Please don't spam the api. This api is deployed on a free web service. You can clone this repository on your local server for testing purposes.
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.

Table of Contents

Installation
- Local installation
Deployment
- Vercel
- Render
Documentation
Pull Requests
Reporting Issues
Support

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

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` Basic info

  GET /api/

Endpoint

  https://anime-api-five-woad.vercel.app/api/

No parameter required ❌

Example of request

import axios from "axios";
const resp = await axios.get("https://anime-api-five-woad.vercel.app/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

  https://anime-api-five-woad.vercel.app/api/info?id={string}

No parameter required ❌

Example of request

import axios from "axios";
const resp = await axios.get(
  "https://anime-api-five-woad.vercel.app/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` specified anime's info

  GET /api/info

Endpoint

  https://anime-api-five-woad.vercel.app/api/info?id={string}

Parameters

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

Example of request

import axios from "axios";
const resp = await axios.get(
  "https://anime-api-five-woad.vercel.app/api/info?id=yami-shibai-9-17879"
);
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "data": {
      "id":string,
      "data_id": number,
      "title": string,
      "japanese_title": string,
      "poster": 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

  https://anime-api-five-woad.vercel.app/api/random

Example of request

import axios from "axios";
const resp = await axios.get(
  "https://anime-api-five-woad.vercel.app/api/random"
);
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "data": {
      "id":string,
      "data_id": number,
      "title": string,
      "japanese_title": string,
      "poster": 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` several categories info

  GET /api/<category>

Endpoint

  https://anime-api-five-woad.vercel.app/api/{string}?page={number}
  #or
  https://anime-api-five-woad.vercel.app/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(
  "https://anime-api-five-woad.vercel.app/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
        }
      },
      {
        "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
        }
      },
      {...}
    ]
  }
}

`Get` search result's info

  GET /api/search

Endpoint

  https://anime-api-five-woad.vercel.app/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(
  "https://anime-api-five-woad.vercel.app/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` suggestions

  GET /api/search

Endpoint

  https://anime-api-five-woad.vercel.app/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(
  "https://anime-api-five-woad.vercel.app/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` anime's episode list

  GET /api/episode/

Endpoint

  https://anime-api-five-woad.vercel.app/api/episode/{param}

Parameters

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

Example of request

import axios from "axios";
const resp = await axios.get(
  "https://anime-api-five-woad.vercel.app/api/episodes/one-piece-100"
);
console.log(resp.data);

Sample Response

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

`Get` schedule of upcoming anime

  GET /api/schedule

Endpoint

  https://anime-api-five-woad.vercel.app/api/schedule?date={string}

Parameters

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

Example of request

import axios from "axios";
const resp = await axios.get(
  "https://anime-api-five-woad.vercel.app/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` servers list

  GET /api/servers/

Endpoint

  https://anime-api-five-woad.vercel.app/api/schedule?date={string}

Parameters

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

Example of request

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

Sample Response

{
  "success": true,
  "results": [
    {
      "type":string,
      "dataId":number,
      "serverId":number,
      "serverName":string,
    },
    {...}
  ]
}

`Get` streaming info

  GET /api/stream

Endpoint

  https://anime-api-five-woad.vercel.app/api/stream?id={string}

Parameters

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

Example of request

import axios from "axios";
const resp = await axios.get(
  "https://anime-api-five-woad.vercel.app/api/stream?id=frieren-beyond-journeys-end-18542?ep=107257"
);
console.log(resp.data);

Sample Response

{
  "success": true,
  "results": {
    "streamingInfo": [
      {
        "status": "fulfilled",
        "value": {
          "decryptionResult": {
            "link": string,
            "server": string,
            "type": "dub"
          },
          "subtitleResult": {
            "subtitles": [
              {
                "file": string,
                "label": string,
                "kind": string,
                "default": boolean
              },
              {
                "file": string,
                "kind": string
              }
            ],
            "intro": [Object],
            "outro": [Object]
          }
        }
      },
      {...},
      {
        "status": "fulfilled",
        "value": {
          "decryptionResult": {
            "link": string,
            "server": string,
            "type": "sub"
          },
          "subtitleResult": {
            "subtitles": [
              {
                "file": string,
                "label": string,
                "kind": string
              },
              {...}
            ],
            "intro": [Object],
            "outro": [Object]
          }
        }
      },
      {...}
    ],
    "servers": [
      {
        "type":string,
        "data_id": number,
        "server_id": number,
        "server_name": string
      },
      {...}
    ]
  }
}

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 169 Commits
api		api
public		public
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package.json		package.json
render.yaml		render.yaml
vercel.json		vercel.json

License

itzzzme/anime-api

Folders and files

Latest commit

History

Repository files navigation

Anime API

! Disclaimer !

Table of Contents

Installation

Local installation

Deployment

Vercel

Render

Documentation

Get Basic 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 specified anime's info

Endpoint

Parameters

Example of request

Sample Response

Get random anime's info

Endpoint

Example of request

Sample Response

Get several categories info

Endpoint

Parameters

List of Categories

Example of request

Sample Response

Get search result's info

Endpoint

Parameters

Example of request

Sample Response

Get suggestions

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 servers list

Endpoint

Parameters

Example of request

Sample Response

Get streaming info

Endpoint

Parameters

Example of request

Sample Response

Pull Requests

Reporting Issues

Support

About

Topics

Resources

License

Stars

Watchers

Forks

`Get` Basic info

`Get` Top 10 anime's info

`Get` specified anime's info

`Get` random anime's info

`Get` several categories info

`Get` search result's info

`Get` suggestions

`Get` anime's episode list

`Get` schedule of upcoming anime

`Get` servers list

`Get` streaming info

Packages