search

consumet / api.consumet.org

A Modern Search Engine API for Anime, Movies/TVShows, Books, Light Novels, Manga, etc.
https://docs.consumet.org
GNU General Public License v3.0
1.18k stars 537 forks source link
anilist anime anime-api api books books-api comics comics-api light-novels lightnovel-api manga manga-api movies movies-api rest-api scraper search-engine streaming streaming-api typescript

readme

Consumet

Consumet API

Consumet provides an APIs for accessing information and links for various entertainments like movies, books, anime, etc.

Discord Discord Discord GitHub

Consumet scrapes data from various websites and provides APIs for accessing the data to satisfy your needs.

[!IMPORTANT] Self-hosting the Consumet is required to use the API. Consumet API is no longer publicly available. Please refer to the Installation section for more information on hosting your own instance.

[!CAUTION] Consumet is not affiliated with any of the providers it scrapes data from. Consumet is not responsible for any misuse of the data provided by the API. Commercial utilization may lead to serious consequences, including potential site takedown measures. Ensure that you understand the legal implications before using this API.

Table of Contents

Installation

Locally

installation is simple.

Run the following command to clone the repository, and install the dependencies.

$ git clone https://github.com/consumet/api.consumet.org.git
$ cd api.consumet.org
$ npm install #or yarn install

start the server!

$ npm start #or yarn start

Docker

Docker image is available at Docker Hub.

run the following command to pull and run the docker image.

$ docker pull riimuru/consumet-api
$ docker run -p 3000:3000 riimuru/consumet-api

This will start the server on port 3000. You can access the server at http://localhost:3000/, And can change the port by changing the -p option to -p <port>:3000.

Be sure to set NODE_ENV to PROD in your environment variables when running your own instance. Check out the .env.example file for more information.

You can add -d flag to run the server in detached mode.

Heroku

Host your own instance of Consumet API on Heroku using the button below.

Deploy on Heroku

Vercel

Host your own instance of Consumet API on Vercel using the button below.

Deploy with Vercel

Render

Host your own instance of Consumet API on Render using the button below.

Deploy to Render

Railway

Host your own instance of Consumet API on Railway using the button below.

Deploy on Railway

Documentation

Please refer to the documentation. Join our Discord server if you need any additional help or have any questions, comments, or suggestions.

Development

Pull requests and stars are always welcome, for bugs and features create a new issue. If you're brave to make make a commit to the project see CONTRIBUTING.md.

Showcases

Showcases are welcome! If you have a project that uses Consumet API, please let us know by making a new discussion here or by joining our Discord server. We will add your project to our showcases page.

Provider Request

Make a new issue with the name of the provider on the title, as well as a link to the provider in the body paragraph.

Support

You can contact the maintainers of consumet.ts via email, or join the discord server (Recommended).

Contributors ✨

Thanks to the following people for keeping this project alive and thriving.

Related repositories