ANIME-API

Are you not tired of searching where you can watch or download your favorite animes ? To search on hundred of website until you find what you are looking for ? If yes, this API is for you. This API is a powerful scraper of many streaming and downloading website. With this API, you can search a page about your favorite anime or search for a download link or streaming link for enjoying your favorite animes.

npm install @justalk/anime-api

Short Example

If you want to search for a streaming link of the episode 387 of naruto shippuden

const animeapi = require('@justalk/anime-api');
const download = await animeapi.download('naruto shippuden', 387);

Features

• Get page links: Get the page links of the anime on many website by searching an anime by name

• Get streaming links: Get the streaming link of an episode of an anime by anime name

• Get download links: Get the direct download link of an episode of an anime by anime name

API

Search page link by anime name

async links(search, options)

| name | type | description | | :--- | :---------- | :--- | | search | String | name of the anime searched | | options | Object | (optionnal) List of the options |

Lists of optionnal options available for page links

| name of key | return type | description | | :--- | :---------- | :--- | | limit_per_website | Number | Limit the number of result per website | | limit | Number | Limit the number of total result | | website | String | Website that you wanna target, see under for the complete list |

Format response of links

| name of key | return type | description | | :--- | :---------- | :--- | | source | String | Name of the source | | title | String | Complete title of the anime on the website | | link | String | Link of the anime| | levenshtein | Number | Difference of character from the search |

The result is order by levenshtein. The first result will be the closest from your research.

Search streaming links by anime name

async stream(search, episode, options)

| name | type | description | | :--- | :---------- | :--- | | search | String | name of the anime searched | | episode | Number | number of the episode searched | | options | Object | (optionnal) List of the options |

Lists of optionnal options available for stream links

| name of key | return type | description | | :--- | :---------- | :--- | | limit_per_website | Number | Limit the number of result per website |

Format response of stream

| name of key | return type | description | | :--- | :---------- | :--- | | source | String | Name of the source | | link | String | Link of the stream |

Only one result by source will be provided.

Search downloading links by anime name

async download(search, episode, options)

| name | type | description | | :--- | :---------- | :--- | | search | String | name of the anime searched | | episode | Number | number of the episode searched | | options | Object | (optionnal) List of the options |

Lists of optionnal options available for download links

| name of key | return type | description | | :--- | :---------- | :--- | | limit_per_website | Number | Limit the number of result per website |

Format response of download

| name of key | return type | description | | :--- | :---------- | :--- | | source | String | Name of the source | | link | String | Link of the download |

Only one result by source will be provided.

List of website available

The list below show the website scraped by the API and the website available for the option website

| website variable | website url | | :--- | :---------- | | ANIMELAND | https://www.animeland.us/ | | CHIA-ANIME | http://www.chia-anime.me/ | | ANIMEOUT | https://www.animeout.xyz/ | | GOGOANIME | https://www3.gogoanime.pro/ | | ANIMEFREAK | https://www.animefreak.tv/ |

The list is increasing slowly. I am working on it.

Examples

Searching page link of naruto shippuden

const animeapi = require('@latsuj/anime-api');
const results = await animeapi.links('Naruto shippuden');

results = [{
    source: 'ANIMELAND',
    title: 'Naruto Shippuden',
    link: 'https://www.animeland.us/dub/naruto-shippuden',
    levenshtein: 2
  },
  {
    source: 'CHIA-ANIME',
    title: 'Naruto Shippuden',
    link: 'http://www.chia-anime.me/episode/naruto%e3%83%8a%e3%83%ab%e3%83%88%e7%96%be%e9%a2%a8%e4%bc%9danime/',
    levenshtein: 7
  },
  {
    source: 'ANIMEOUT',
    title: 'Naruto Shippuden Movie 7 The Last',
    link: 'https://www.animeout.xyz/dub/naruto-shippuden-movie-7-the-last',
    levenshtein: 19
}]

Searching stream link of naruto shippuden episode 387

const animeapi = require('@justalk/anime-api');
const stream = await animeapi.stream('naruto shippuden', 387);

results = [{
    source: 'ANIMELAND',
    link: 'https://www.animeland.us/naruto-shippuden-episode-500-english-dubbed'
  },
  {
    source: 'CHIA-ANIME',
    link: 'http://www.chia-anime.me/naruto-shippuden-episode-500-english-subbed/'
}]

Searching download link of naruto shippuden episode 387 with options

const animeapi = require('@justalk/anime-api');
const download = await animeapi.download('naruto shippuden', 387, {website: 'CHIA-ANIME'});

results = [{
  {
    source: 'CHIA-ANIME',
    link: 'http://www.chia-anime.me/naruto-shippuuden-episode-387-english-subbed/'
}]

How to contribute/test

For testing, install the node project and run the test command.

node install
npm test

Also, you can use the command under for running the test without the linter

npm run test-no

The API has two kind of tests.

1. dynamic : Perform query on the real Website.
2. static : Run the API through website mock, allowing the tests to be more precise.

I am also using winston for filling up logs.

License

MIT - Copyright © JUSTAL Kevin