Skip to content

Repository files navigation

Comick Source API

Next.js API for scraping manga metadata from multiple sources.

Live API | Userscript

SourceIDBase URLStatus
Arven Comicsarven-comicshttps://arvencomics.comActive
Arya Scansarya-scanshttps://brainrotcomics.comUnstable
Asmodeus Scansasmodeus-scanshttps://asmotoon.comActive
AsuraScanasurascanhttps://asurascans.comActive
Athrea Scansathrea-scanshttps://athreascans.comActive
AtsuMoeatsumoehttps://atsumoe.comUnstable
Batobatohttps://bato.toShutdown
Comixcomixhttps://comix.toUnstable
DemonicScansdemonicscanshttps://demonicscans.orgUnstable
Diva Scansdiva-scanshttps://divatoon.comUnstable
Elf Toonelf-toonhttps://elftoon.comActive
Eva Scanseva-scanshttps://evascans.orgActive
Falcon Scansfalcon-scanshttps://falconscans.comShutdown
Firescansfirescanshttps://firescans.xyzUnstable
FlameComicsflamecomicshttps://flamecomics.xyzActive
Galaxy Degen Scansgalaxy-degen-scanshttps://gdscans.comActive
Greed Scansgreed-scanshttps://greedscans.comActive
Hades Scanshades-scanshttps://hadesscans.comActive
KaliScankaliscanhttps://kaliscan.comActive
KappaBeastkappabeasthttps://kappabeast.comActive
KDT Scanskdt-scanshttps://www.silentquill.netActive
Kenscanskenscanshttps://kencomics.comActive
KS Groupks-group-scanshttps://ksgroupscans.comActive
KuraMangakuramangahttps://kuramanga.comActive
LagoonScanslagoonscanshttps://lagoonscans.comActive
LHTranslationlhtranslationhttps://lhtranslation.netActive
LikeMangalikemangahttps://likemanga.ioActive
Lua Comiclua-comichttps://luacomic.orgActive
Madarascansmadarascanshttps://madarascans.comActive
Magus Mangamagus-mangahttps://magustoon.orgActive
MangaCloudmangacloudhttps://mangacloud.orgUnstable
Mangagomangagohttps://www.mangago.zoneUnstable
MangaKatanamangakatanahttps://mangakatana.comActive
Mangaloommangaloomhttps://mangaloom.comActive
MangaParkmangaparkhttps://mangapark.ioShutdown
MangaReadmangareadhttps://mangaread.orgActive
Mangasushimangasushihttps://mangasushi.orgActive
Mangataromangatarohttps://mangataro.orgActive
MangaYYmangayyhttps://mangayy.orgActive
Manhuaplusmanhuaplushttps://manhuaplus.topActive
ManhuaUSmanhuaushttps://manhuaus.comUnstable
Mgekomgekohttps://mgeko.ccActive
Mist Scansmist-scanshttps://mistscans.comActive
NovelCoolnovelcoolhttps://www.novelcool.comUnstable
Philia Scansphilia-scanshttps://philiascans.orgUnstable
Project Sukiproject-sukihttps://projectsuki.comActive
Qi Scansqi-scanshttps://qimanhwa.comUnstable
Rage Scansrage-scanshttps://ragescans.comUnstable
Raven Scansraven-scanshttps://ravenscans.orgActive
RD Scansrd-scanshttps://rdscans.comUnstable
Ritharscansritharscanshttps://ritharscans.comUnstable
Rizz Fablesrizz-fableshttps://rizzfables.comActive
Rokari Comicsrokari-comicshttps://rokaricomics.comActive
Scythe Scansscythe-scanshttps://scythescans.comActive
Spider Scansspider-scanshttps://spiderscans.xyzActive
Stonescapestonescapehttps://stonescape.xyzActive
Temple Scantemple-scanhttps://templetoons.comActive
Thunderscansthunderscanshttps://en-thunderscans.comActive
TopManhuatopmanhuahttps://manhuatop.orgActive
UTOONutoonhttps://utoon.netActive
Violetscansvioletscanshttps://violetscans.orgActive
Vortex Scansvortex-scanshttps://vortexscans.orgActive
WEBTOONwebtoonhttps://www.webtoons.comActive
WeebCentralweebcentralhttps://weebcentral.comActive
Weebdexweebdexhttps://weebdex.orgShutdown
WitchScanswitchscanshttps://witchscans.comActive
Writers' Scanswriters-scanshttps://writerscans.comActive
Yaksha Comicsyaksha-comicshttps://yakshacomics.comActive
Yaksha Scansyaksha-scanshttps://yakshascans.comActive

Setup

git clone https://github.com/GooglyBlox/comick-source-api.git
cd comick-source-api
npm install
npm run dev

Runs on http://localhost:3000

Production:

npm run build
npm start

API

GET /api/sources

List all supported sources.

{
"sources": [
{
"id": "mangapark",
"name": "MangaPark",
"baseUrl": "https://mangapark.io",
"description": "MangaPark - https://mangapark.io",
"clientOnly": false,
"type": "aggregator"
}
]
}

POST /api/search

Search manga across sources.

{
"query": "solo leveling",
"source": "mangapark"// or "all"
}

POST /api/chapters

Get chapter list for a manga.

{
"url": "https://mangapark.io/title/75577-en-solo-leveling",
"source": "mangapark"// optional, auto-detected
}

GET /api/health

Check source status. Cached for 5 minutes. Returns cached and cacheAge fields.

POST /api/health

Force refresh health check cache.

GET /api/frontpage

List sources with frontpage support and their available sections.

{
"sources": [
{
"sourceId": "comix",
"sourceName": "Comix",
"availableSections": [
{
"id": "trending",
"title": "Most Recent Popular",
"type": "trending",
"supportsTimeFilter": true,
"availableTimeFilters": [1, 7, 30, 90, 180, 365]
}
]
}
],
"sourceIds": ["comix"]
}

POST /api/frontpage

Fetch frontpage section data from a source.

{
"source": "comix",
"section": "trending",
"page": 1,
"limit": 30,
"days": 7
}

Available sections for Comix:

  • trending - Most Recent Popular (supports time filter)
  • most_followed - Most Followed New Comics (supports time filter)
  • latest_hot - Latest Updates (Hot)
  • latest_new - Latest Updates (New)
  • recently_added - Recently Added
  • completed - Complete Series

GET /api/proxy/html

Proxy requests to AsuraScans and WeebCentral (CORS workaround).

GET /api/proxy/html?url=https://asurascans.com/...

Usage

curl -X POST https://comick-source-api.notaspider.dev/api/search \
-H "Content-Type: application/json" \
-d '{"query": "one piece", "source": "all"}'
constres=awaitfetch("https://comick-source-api.notaspider.dev/api/search",{method: "POST",headers: {"Content-Type": "application/json"},body: JSON.stringify({query: "chainsaw man",source: "all"})});

Development

npm run dev # dev server
npm run build # production build
npm test# run tests
npm run test:sources # test scrapers
npm run lint # eslint

See CONTRIBUTING.md for guidelines on adding sources.

Deployment

Deploy with Vercel

docker build -t comick-source-api .
docker run -p 3000:3000 comick-source-api

No environment variables required.

License

For educational purposes. Respect source website ToS.

About

A RESTful API built with Next.js for scraping manga and comic metadata from multiple sources.

Topics

Resources

Contributing

Stars

16 stars

Watchers

0 watching

Forks

Sponsor this project

Contributors

Languages