4anime-scraper

A web scraper for 4anime.to

Usage no npm install needed!

<script type="module">
  import animeScraper from 'https://cdn.skypack.dev/4anime-scraper';
</script>

README

4anime Web scraper

This anime web scraper uses the 4anime.to website to get data of any anime available on the platform.

The data includes the name, the genres, the description, the type of show, the studio that produced the show, the release date, the status- i.e. completed or ongoing-, the language- i.e. subbed or dubbed, the url of the page, and the episodes.

The episodes have the following information: the episode id, the episode number, and the episode url.

Installation

npm install 4anime-scraper

Information

Anime object structure

Anime {
  name: string,
  genres: array of strings,
  description: string,
  imageUrl: string,
  type: string,
  studio: string,
  releaseDate: string,
  status: string,
  language: string,
  url: string,
  episodes: array of objects
}

Episode object structure

    {
      id: int,
      episode: int,
      url: string
    }

Usage

There are two functions to this package. One takes in a string and returns a list of all anime that came from the search result. The other takes in a url to the anime page and returns all the data regarding that page alone.

Getting data from url

Anime.getAnimeFromURL("https://4anime.to/anime/the-god-of-high-school")
    .then(res => {
        console.log(res);
    });

Sample response

Anime {
  name: 'The God of High School',
  genres: [
    'Action',
    'Adventure',
    'Comedy',
    'Fantasy',
    'Martial Arts',
    'Sci-Fi',
    'Supernatural'
  ],
  description: 'It all began as a fighting tournament to seek out for the best fighter among all high school students in Korea. Mori Jin, a Taekwondo specialist and a high school student, soon learns that there is something much greater beneath the stage of the tournament.',
  type: 'TV Series',
  studio: 'MAPPA',
  releaseDate: 'Summer, 2020',
  status: 'Currently Airing',
  language: 'Subbed',
  url: 'https://4anime.to/anime/the-god-of-high-school',
  episodes: [
    {
      id: 42172,
      episode: 1,
      url: 'https://4anime.to/the-god-of-high-school-episode-01/?id=42172'
    },
    {
      id: 42546,
      episode: 2,
      url: 'https://4anime.to/the-god-of-high-school-episode-02/?id=42546'
    },
    {
      id: 42710,
      episode: 3,
      url: 'https://4anime.to/the-god-of-high-school-episode-03/?id=42710'
    },
    {
      id: 42822,
      episode: 4,
      url: 'https://4anime.to/the-god-of-high-school-episode-04/?id=42822'
    },
    {
      id: 42950,
      episode: 5,
      url: 'https://4anime.to/the-god-of-high-school-episode-05/?id=42950'
    }
  ]
}

Getting data from a search

const Anime = require('4anime-scraper').default;

Anime.getAnimeFromSearch("enen no shouboutai")
    .then(res => {
        console.log(res);
    });

Getting the video link from an episode url

const Anime = require('4anime-scraper').default;

Anime.getVideoLinkFromUrl("https://4anime.to/one-piece-episode-938?id=43181")
    .then(res => {
        console.log(res);
    });

Getting ongoing anime links

Anime.getOngoingLinks()
  .then(res => {
    console.log(res);
  });

Downloading anime episode from video link

This function takes in the video link returned from the getVideoLinkFromURL() function and downloads the video either in current working directory of the .js file or a given path.

// No given path
Anime.downloadVideoFromLink("https://storage.googleapis.com/justawesome-183319.appspot.com/v2.4animu.me/Higurashi-no-Naku-Koro-ni-Gou/Higurashi-no-Naku-Koro-ni-Gou-Episode-04-1080p.mp4")

// With a given path
Anime.downloadVideoFromLink("https://storage.googleapis.com/justawesome-183319.appspot.com/v2.4animu.me/Higurashi-no-Naku-Koro-ni-Gou/Higurashi-no-Naku-Koro-ni-Gou-Episode-04-1080p.mp4", "./test")

Changes

  • Fixed "undefined" TypeError in getAnimeFromURL
  • Fixed 403 errors in episode links
  • Added video download functionality

Contribution

If you would like to add to this package please feel free to send in a pull request.

Contributors

  • Bondiiisan
  • tshrpl

Other

If you would like to check out the code there will be a link to the github page.

Thanks for checking out this package.