Gogoanime is a custom API that provides data from the `gogoanime` website. You will have access to the entire catalog whether movies, series, current episodes, etc., with English subtitles.
🎉 Updates in version v1.0.3 🎉
-
animeEpisodeHandlernow handles invalid episode ids instead of crashing - Can now pass the gogoanime website url via a .env file or via an environment variable.
🚀 Custom gogoanime API Link
API URL DOES NOT WORK gogoanime api
Installation
Define the current gogoanime website url in a .env file or as an environment variable. An example is provided in the .env.example file.
In order to install the project and all dependencies, enter in the project folder and run npm install
Start Local Node/Express Server
npm run startor
npm run devTesting API Methods
npm run dev-api🤝 Contributing
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -am 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request
API Documentation
const api = require('gogoanime');📣 Read this please | To get the videos!📣
api.animeEpisodeHandler([id])
First of all I must mention that the url of the videos work only using the iframe element.
To get the videos (servers) of each chapter, you only need to use the api.animeEpisodeHandler function that receives the id of the episode as a parameter.
To verify the id of each episode, look at the episodes property:
"episodes":
[
{
"id": "actors-songs-connection-episode-1"
},
{
"id": "actors-songs-connection-episode-2"
},
{
"id": "actors-songs-connection-episode-3"
},
{
"id": "actors-songs-connection-episode-4"
},
{
"id": "actors-songs-connection-episode-5"
},
{
"id": "actors-songs-connection-episode-6"
},
{
"id": "actors-songs-connection-episode-7"
},
{
"id": "actors-songs-connection-episode-8"
},
{
"id": "actors-songs-connection-episode-9"
}
]You just have to pass the id of the episode
api.animeEpisodeHandler('actors-songs-connection-episode-9')
.then(res =>{
console.log(res)
});// 20191206103017
// https://gogoanime.now.sh/api/v1/AnimeEpisodeHandler/actors-songs-connection-episode-9
{
"anime": [
{
"img": "https://cdnimg.xyz/cover/actors-songs-connection.png",
"synopsis": "Plot Summary: Private Tenshou Gakuen is the seventh of ten school districts circled within a 130-meter tall wall with restricted entry and egress aside from officials. The academy is fully autonomous by the government but to strive for independence, the school allows students to engage in club activities after school, which comes with a strangely unique system. Each club is ranked according to its overall accumulated points gathered from various club activities and school events. Points can also be received by winning at the school's periodic Tenshou Gakuen Singing Contest, where many students compete. The members in the clubs work hard to win the contest for their goal.",
"genres": [
"music",
"school"
],
"category": "fall-2019-anime",
"released": 2019,
"status": "Ongoing",
"otherName": "ACTORS -Songs Connection-",
"totalEpisodes": 9,
"servers": [
{
"name": "Vidstreaming",
"iframe": "vidstreaming.io/streaming.php?id=MTM0NDQ5&title=Actors%3A+Songs+Connection+Episode+9"
},
{
"name": "Xstreamcdn",
"iframe": "https://www.fembed.com/v/ln5grsnzq283xe6"
},
{
"name": "Vidcdn",
"iframe": "vidstreaming.io/load.php?id=MTM0NDQ5&title=Actors%3A+Songs+Connection+Episode+9"
},
{
"name": "Mp4Upload",
"iframe": "https://www.mp4upload.com/embed-fiib7037qzho.html"
}
]
}
]
}Now you just need to use the iframe property of each server and pass it to the iframe
<iframe
src="vidstreaming.io/streaming.php?id=MTM0NDQ5&title=Actors%3A+Songs+Connection+Episode+9"
width="100%"
height="100%"
frameborder="0"
allowfullscreen
>
</iframe>api.search([query])
// 20191206103743
// https://gogoanime.now.sh/api/v1/Search/tokyo%20ghoul
{
"search": [
{
"title": "Tokyo Ghoul",
"img": "https://cdnimg.xyz/images/summer/Tokyo Ghoul.jpg",
"synopsis": "Plot Summary: Tokyo is haunted by mysterious ghouls who are devouring humans. People are gripped by the fear of these ghouls whose identities are masked in mystery. An ordinary college student named Kaneki encounters Rize, a girl who is an avid reader like he is, at the café he frequents. Little does Kaneki realize that his fate will change overnight.",
"genres": [
"action",
"drama",
"horror",
"mystery",
"psychological",
"supernatural"
],
"released": 2014,
"status": "Completed",
"otherName": "東京喰種-トーキョーグール-",
"totalEpisodes": 12,
"episodes": [
{
"id": "tokyo-ghoul-episode-1"
},
{
"id": "tokyo-ghoul-episode-2"
},
{
"id": "tokyo-ghoul-episode-3"
},
{
"id": "tokyo-ghoul-episode-4"
},
{
"id": "tokyo-ghoul-episode-5"
},
{
"id": "tokyo-ghoul-episode-6"
},
{
"id": "tokyo-ghoul-episode-7"
},
{
"id": "tokyo-ghoul-episode-8"
},
{
"id": "tokyo-ghoul-episode-9"
},
{
"id": "tokyo-ghoul-episode-10"
},
{
"id": "tokyo-ghoul-episode-11"
},
{
"id": "tokyo-ghoul-episode-12"
}
]
},
]
}api.recentReleaseEpisodes([page])
| Page From | Limit |
|---|---|
| 1 | 257 |
// 20191206103924
// https://gogoanime.now.sh/api/v1/RecentReleaseEpisodes/1
{
"anime": [
{
"title": "Wan Jie Xian Zong 2nd Season",
"img": "https://cdnimg.xyz/cover/wan-jie-xian-zong-2nd-season.png",
"synopsis": "Plot Summary: Second Season of Wonderland of Ten Thousands.\n\n",
"genres": [
"action",
"adventure",
"demons",
"fantasy",
"historical",
"martial-arts",
"romance"
],
"category": "ona",
"episode": 56,
"totalEpisodes": 56,
"released": 2019,
"status": "Ongoing",
"otherName": "Wonderland 2nd Season, The Wonderland of Ten Thousands 2, 万界仙踪 第2季",
"servers": [
{
"name": "Vidstreaming",
"iframe": "vidstreaming.io/streaming.php?id=MTM0NTk1&title=Wan+Jie+Xian+Zong+2nd+Season+Episode+56"
},
{
"name": "Xstreamcdn",
"iframe": "https://www.fembed.com/v/rywg2heplr76xqy"
},
{
"name": "Vidcdn",
"iframe": "vidstreaming.io/load.php?id=MTM0NTk1&title=Wan+Jie+Xian+Zong+2nd+Season+Episode+56"
},
{
"name": "Mp4Upload",
"iframe": "https://www.mp4upload.com/embed-q8d1ex59q2ki.html"
}
]
},
]
}Iframe Decoder for url vidstreaming
If you don't want to directly load the video iframe in your application, you can use the decoder.
api.decodeVidstreamingIframeURL([iframe_url])
This decoder returns a list of videos type mp4 or m3u8. To play the m3u8 videos you would have to use some HLS player
const iframe = 'vidstreaming.io/load.php?id=MTM0NTk1&title=Wan+Jie+Xian+Zong+2nd+Season+Episode+56';
await api.decodeVidstreamingIframeURL(iframe)
.then(urls =>{
console.log(urls)
});[
{
option: 1,
url: 'https://hls12xx.cdnfile.info/hls/9296cf197ecfe26b540cd67afd84dfa9/sub.56.m3u8'
},
{
option: 2,
url: 'https://st1.cdnfile.info/user1342/9296cf197ecfe26b540cd67afd84dfa9/EP.56.fullp.mp4?token=VOJQfydPCH9VHwRDkrVWpg&expires=1588377949&id=134595'
}
]api.recentlyAddedSeries()
// 20191206104022
// https://gogoanime.now.sh/api/v1/RecentlyAddedSeries
{
"anime": [
{
"title": "Master Keaton",
"img": "https://cdnimg.xyz/cover/master-keaton.png",
"synopsis": "Plot Summary: Taichi Keaton is a half-British half-Japanese archeologist and SAS veteran of the Falklands War. He solves mysteries and investigates insurance fraud for Lloyd's around the world.\n",
"genres": [
"adventure",
"drama",
"historical",
"mystery",
"seinen",
"slice-of-life"
],
"released": 1998,
"status": "Completed",
"otherName": "Master Keaton: Blood and Bullets, マスターキートン",
"totalEpisodes": 39,
"episodes": [
{
"id": "master-keaton-episode-1"
},
{
"id": "master-keaton-episode-2"
},
{
"id": "master-keaton-episode-3"
},
{
"id": "master-keaton-episode-4"
},
{
"id": "master-keaton-episode-5"
},
{
"id": "master-keaton-episode-6"
},
{
"id": "master-keaton-episode-7"
},
{
"id": "master-keaton-episode-8"
},
{
"id": "master-keaton-episode-9"
},
{
"id": "master-keaton-episode-10"
},
{
"id": "master-keaton-episode-11"
},
{
"id": "master-keaton-episode-12"
},
{
"id": "master-keaton-episode-13"
},
{
"id": "master-keaton-episode-14"
},
{
"id": "master-keaton-episode-15"
},
{
"id": "master-keaton-episode-16"
},
{
"id": "master-keaton-episode-17"
},
{
"id": "master-keaton-episode-18"
},
{
"id": "master-keaton-episode-19"
},
{
"id": "master-keaton-episode-20"
},
{
"id": "master-keaton-episode-21"
},
{
"id": "master-keaton-episode-22"
},
{
"id": "master-keaton-episode-23"
},
{
"id": "master-keaton-episode-24"
},
{
"id": "master-keaton-episode-25"
},
{
"id": "master-keaton-episode-26"
},
{
"id": "master-keaton-episode-27"
},
{
"id": "master-keaton-episode-28"
},
{
"id": "master-keaton-episode-29"
},
{
"id": "master-keaton-episode-30"
},
{
"id": "master-keaton-episode-31"
},
{
"id": "master-keaton-episode-32"
},
{
"id": "master-keaton-episode-33"
},
{
"id": "master-keaton-episode-34"
},
{
"id": "master-keaton-episode-35"
},
{
"id": "master-keaton-episode-36"
},
{
"id": "master-keaton-episode-37"
},
{
"id": "master-keaton-episode-38"
},
{
"id": "master-keaton-episode-39"
}
]
},
]
}api.alphabetList([letter] , [page])
| Letter | Page Limit |
|---|---|
| '0' | (zero value means , numbers in the title) [1 .. 53] |
| 'A' | [1 .. 4] |
| 'C' | [1 .. 3] |
| 'D' | [1 .. 4] |
| 'E' | [1 .. 1] |
| 'F' | [1 .. 2] |
| 'G' | [1 .. 3] |
| 'H' | [1 .. 4] |
| 'I' | [1 .. 2] |
| 'J' | [1 .. 1] |
| 'K' | [1 .. 4] |
| 'L' | [1 .. 2] |
| 'M' | [1 .. 4] |
| 'N' | [1 .. 2] |
| 'O' | [1 .. 2] |
| 'P' | [1 .. 1] |
| 'Q' | [1 .. 1] |
| 'R' | [1 .. 2] |
| 'S' | [1 .. 6] |
| 'T' | [1 .. 4] |
| 'U' | [1 .. 1] |
| 'V' | [1 .. 1] |
| 'W' | [1 .. 1] |
| 'Z' | [1 .. 1] |
| 'Y' | [1 .. 2] |
| 'Z' | [1 .. 1] |
// 20191206104143
// https://gogoanime.now.sh/api/v1/Alphabet/a/1
{
"anime": [
{
"title": "A Channel",
"img": "https://cdnimg.xyz/images/anime/a-channel8.jpg",
"synopsis": "Plot Summary: Toeru takes a test so she can enter the same high school as Run, the girl she likes. She passes, but when she goes to tell Run, she finds her hugging a girl she’s never seen before.",
"genres": [
"comedy",
"school",
"seinen",
"slice-of-life"
],
"released": 2011,
"status": "Completed",
"otherName": "A-Channel: The Animation, Aチャンネル",
"totalEpisodes": 12,
"episodes": [
{
"id": "a-channel-episode-1"
},
{
"id": "a-channel-episode-2"
},
{
"id": "a-channel-episode-3"
},
{
"id": "a-channel-episode-4"
},
{
"id": "a-channel-episode-5"
},
{
"id": "a-channel-episode-6"
},
{
"id": "a-channel-episode-7"
},
{
"id": "a-channel-episode-8"
},
{
"id": "a-channel-episode-9"
},
{
"id": "a-channel-episode-10"
},
{
"id": "a-channel-episode-11"
},
{
"id": "a-channel-episode-12"
}
]
},
]
}api.popular([page])
| Page From | Limit |
|---|---|
| 1 | 345 |
// 20191206104224
// https://gogoanime.now.sh/api/v1/Popular/1
{
"popular": [
{
"title": "Arifureta Shokugyou de Sekai Saikyou",
"img": "https://cdnimg.xyz/cover/arifureta-shokugyou-de-sekai-saikyou.png",
"synopsis": "Plot Summary: Seventeen-year-old Hajime Nagumo is your average, everyday otaku. However, his simple life of pulling all-nighters and sleeping in school is suddenly turned upside down when he, along with the rest of his class, is summoned to a fantasy world! They're treated like heroes and tasked with the duty of saving the human race from utter extinction. But what should have been any otaku's wet dream quickly turns into Hajime's nightmare. While the rest of his class are blessed with godlike powers, Hajime's job, Synergist, only has a single transmutation skill. Ridiculed and bullied by his classmates for being weak, he soon finds himself in despair. Will he be able to survive in this dangerous world of monsters and demons with only a glorified blacksmith's level of strength?",
"genres": [
"action",
"adventure",
"fantasy",
"harem"
],
"released": 2019,
"status": "Completed",
"otherName": "Arifureta: From Commonplace to World's Strongest, ありふれた職業で世界最強",
"totalEpisodes": 13,
"episodes": [
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-1"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-2"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-3"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-4"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-5"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-6"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-7"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-8"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-9"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-10"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-11"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-12"
},
{
"id": "arifureta-shokugyou-de-sekai-saikyou-episode-13"
}
]
},
]
} api.genres([genre] , [page])
| Genres | Page Info | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
// 20191206104423
// https://gogoanime.now.sh/api/v1/Genre/action/2
{
"anime": [
{
"title": "Tenpou Ibun Ayakashi Ayashi Inferno OVA (Dub)",
"img": "https://cdnimg.xyz/cover/tenpou-ibun-ayakashi-ayashi-inferno-ova-dub.png",
"synopsis": "Plot Summary: Specials set six months after the end of Tenpou Ibun Ayakashi Ayashi.",
"genres": [
"action",
"drama",
"historical",
"supernatural"
],
"released": 2007,
"status": "Completed",
"otherName": "Ghost Slayers Ayashi: Inferno",
"totalEpisodes": 5,
"episodes": [
{
"id": "tenpou-ibun-ayakashi-ayashi-inferno-ova-dub-episode-1"
},
{
"id": "tenpou-ibun-ayakashi-ayashi-inferno-ova-dub-episode-2"
},
{
"id": "tenpou-ibun-ayakashi-ayashi-inferno-ova-dub-episode-3"
},
{
"id": "tenpou-ibun-ayakashi-ayashi-inferno-ova-dub-episode-4"
},
{
"id": "tenpou-ibun-ayakashi-ayashi-inferno-ova-dub-episode-5"
}
]
},
{
"title": "Strike the Blood II",
"img": "https://cdnimg.xyz/cover/strike-the-blood-ii.png",
"synopsis": "Plot Summary: Strike the Blood new OVAs",
"genres": [
"action",
"ecchi",
"fantasy",
"school",
"shounen",
"supernatural",
"vampire"
],
"released": 2016,
"status": "Completed",
"otherName": "Strike the Blood Second, ストライク・ザ・ブラッドⅡ",
"totalEpisodes": 8,
"episodes": [
{
"id": "strike-the-blood-ii-episode-1"
},
{
"id": "strike-the-blood-ii-episode-2"
},
{
"id": "strike-the-blood-ii-episode-3"
},
{
"id": "strike-the-blood-ii-episode-4"
},
{
"id": "strike-the-blood-ii-episode-5"
},
{
"id": "strike-the-blood-ii-episode-6"
},
{
"id": "strike-the-blood-ii-episode-7"
},
{
"id": "strike-the-blood-ii-episode-8"
}
]
},
]
}api.ongoingSeries()
// 20191206104537
// https://gogoanime.now.sh/api/v1/OngoingSeries
{
"anime": [
{
"title": "Actors: Songs Connection",
"img": "https://cdnimg.xyz/cover/actors-songs-connection.png",
"synopsis": "Plot Summary: Private Tenshou Gakuen is the seventh of ten school districts circled within a 130-meter tall wall with restricted entry and egress aside from officials. The academy is fully autonomous by the government but to strive for independence, the school allows students to engage in club activities after school, which comes with a strangely unique system. Each club is ranked according to its overall accumulated points gathered from various club activities and school events. Points can also be received by winning at the school's periodic Tenshou Gakuen Singing Contest, where many students compete. The members in the clubs work hard to win the contest for their goal.",
"genres": [
"music",
"school"
],
"released": 2019,
"status": "Ongoing",
"otherName": "ACTORS -Songs Connection-",
"totalEpisodes": 9,
"episodes": [
{
"id": "actors-songs-connection-episode-1"
},
{
"id": "actors-songs-connection-episode-2"
},
{
"id": "actors-songs-connection-episode-3"
},
{
"id": "actors-songs-connection-episode-4"
},
{
"id": "actors-songs-connection-episode-5"
},
{
"id": "actors-songs-connection-episode-6"
},
{
"id": "actors-songs-connection-episode-7"
},
{
"id": "actors-songs-connection-episode-8"
},
{
"id": "actors-songs-connection-episode-9"
}
]
},
{
"title": "Actors: Songs Connection (Dub)",
"img": "https://cdnimg.xyz/cover/actors-songs-connection-dub.png",
"synopsis": "Plot Summary: Private Tenshou Gakuen is the seventh of ten school districts circled within a 130-meter tall wall with restricted entry and egress aside from officials. The academy is fully autonomous by the government but to strive for independence, the school allows students to engage in club activities after school, which comes with a strangely unique system. Each club is ranked according to its overall accumulated points gathered from various club activities and school events. Points can also be received by winning at the school's periodic Tenshou Gakuen Singing Contest, where many students compete. The members in the clubs work hard to win the contest for their goal.\n",
"genres": [
"music",
"school"
],
"released": 2019,
"status": "Ongoing",
"otherName": "ACTORS -Songs Connection-",
"totalEpisodes": 1,
"episodes": [
{
"id": "actors-songs-connection-dub-episode-1"
}
]
},
{
"title": "Africa no Salaryman (TV)",
"img": "https://cdnimg.xyz/cover/africa-no-salaryman-tv.png",
"synopsis": "Plot Summary: The comedy follows a lion, toucan, and lizard as they live the lives of office workers in a capitalist society in Japan, while also dealing with their unique situations as animals living beyond the savanna and the food chain.",
"genres": [
"comedy",
"slice-of-life"
],
"released": 2019,
"status": "Ongoing",
"otherName": "Africa Salaryman, アフリカのサラリーマン (TV)",
"totalEpisodes": 9,
"episodes": [
{
"id": "africa-no-salaryman-tv-episode-1"
},
{
"id": "africa-no-salaryman-tv-episode-2"
},
{
"id": "africa-no-salaryman-tv-episode-3"
},
{
"id": "africa-no-salaryman-tv-episode-4"
},
{
"id": "africa-no-salaryman-tv-episode-5"
},
{
"id": "africa-no-salaryman-tv-episode-6"
},
{
"id": "africa-no-salaryman-tv-episode-7"
},
{
"id": "africa-no-salaryman-tv-episode-8"
},
{
"id": "africa-no-salaryman-tv-episode-9"
}
]
},
]
}👥 Credits
- Chris Michael (Project Leader, and Developer)
💢 Troubleshootings
This is just a personal project created for study / demonstration purpose and to simplify my working life, it may or may not be a good fit for your project(s).
❤️ Show your support
Please
Feel free to open issues or submit pull-requests to help me improving my work.
🤖 Author
Chris Michael
Copyright © 2019 Chris Michael.