# @justalk/anime-api

> An api for searching download links, streaming links, pages for your favorite animes

Latest version **3.0.0** (published 2020-09-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install @justalk/anime-api
pnpm add @justalk/anime-api
yarn add @justalk/anime-api
bun add @justalk/anime-api
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2020-09-12 |
| First published | 2020-09-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=12.0.0 |
| Dependencies | 5 |
| Unpacked size | 412.9 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 120 |
| Author | Justal Kevin |
| Maintainers | latsuj |
| Keywords | anime, download, scraper, search, manga, anime-api, streaming |

## Links

- npm: https://www.npmjs.com/package/@justalk/anime-api
- Repository: https://github.com/JustalK/ANIME-API
- Homepage: https://github.com/JustalK/ANIME-API#readme
- Issues: https://github.com/JustalK/ANIME-API/issues
- npm.io page: https://npm.io/package/@justalk/anime-api

## Dependencies (5)

- [got](https://npm.io/package/got.md) ^6.6.3
- [jsdom](https://npm.io/package/jsdom.md) ^16.4.0
- [winston](https://npm.io/package/winston.md) ^3.3.3
- [puppeteer](https://npm.io/package/puppeteer.md) ^5.2.1
- [js-levenshtein](https://npm.io/package/js-levenshtein.md) ^1.1.6

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 3.0.0 (latest) — 2020-09-12
- 2.1.4 — 2020-09-11
- 2.1.3 — 2020-09-11
- 2.1.2 — 2020-09-11
- 2.1.1 — 2020-09-11
- 2.1.0 — 2020-09-11
- 2.0.0 — 2020-09-08
- 1.0.0 — 2020-09-06

## README

# ANIME-API

![Last version npm](https://img.shields.io/npm/v/@justalk/anime-api.svg?style=flat-square)
![Last version](https://img.shields.io/github/v/tag/justalk/anime-api.svg?style=flat-square)
[![Node version](https://img.shields.io/node/v/@justalk/anime-api.svg?style=flat-square)](https://www.npmjs.com/package/@justalk/anime-api)
[![Travis](https://img.shields.io/travis/com/justalk/anime-api.svg?style=flat-square)](https://travis-ci.com/github/JustalK/anime-api)
[![Coverage Status](https://coveralls.io/repos/github/JustalK/ANIME-API/badge.svg?branch=master&style=flat-square)](https://coveralls.io/github/JustalK/anime-api?branch=master)
[![Dependency status](http://img.shields.io/david/justalk/anime-api.svg?style=flat-square)](https://david-dm.org/justalk/anime-api.svg)
![Last version](https://img.shields.io/github/license/justalk/anime-api.svg?style=flat-square)
[![XO code style](https://img.shields.io/badge/code_style-XO-5ed9c7.svg?style=flat-square)](https://github.com/xojs/xo)

![Star the project](https://img.shields.io/github/stars/justalk/anime-api?style=social)

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

```js
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

```js
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

```js
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

```js
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

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

```js
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

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

```js
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

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

```js
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.

```shell
node install
npm test
```

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

```shell
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](https://teamkd.online/)

---
_Source: https://npm.io/package/@justalk/anime-api · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._