Repository navigation
v2.5.1 — Embed Providers, Domain Sync & Latest-Episode Checker
AniKotoAPI v2.5.1
Full release consolidating the 2026-10-13 session: domain sync with the official hub, spotlight-carousel drift fix, direct embed providers, two new bot/dev features, and a complete docs + diagnostics pass.
Added
- Direct Embed Providers — new
GET /api/stream/embedsreturning iframe-ready player URLs for Megavid, AniXo and MegaPlay. Playback happens in the provider's own iframe, so Cloudflare never blocks watch-time requests — no source-site AJAX scraping needed. - Provider Config —
src/configs/embedProviders.config.js: provider registry with URL builders (patterns verified against the AniCult provider registry). - Embed Extractor —
src/extractors/embedProviders.extractor.js: resolves the MAL ID from the site's episode list (data-mal), looks up the AniList ID via the public AniList GraphQL API (cached 60 min), builds provider URLs. - Embed Controller — supports
?slug=,?mal=,?anilist=(direct IDs skip slug scraping entirely),?ep=,?lang=sub|dub,?provider=comma filter; 400 on unknown provider or missing params. - Info External IDs —
GET /api/infonow includesexternalIds: { animeId, malId, anilistId }, resolved server-side (60 min cache, best-effort: failed resolution returnsnulls and never breaks the response). Feed the IDs straight into/api/stream/embeds. - Latest-Episode Checker — new
GET /api/episodes/latest?slug=(newepisodeLatest.controller.js): returns only the newest episode plus summary counts — built for bot polling and notification jobs. 10 min cache; registered before/episodes/:idso the literal path wins. - IDs Cache TTL — new
TTL.ids(60 min) for MAL/AniList ID mappings (these never change per anime). - OpenAPI —
/stream/embedsand/episodes/latestregistered in the spec;/infosummary notes theexternalIdsaddition. - Tests — new
Embed Providers,Embed (direct MAL),Info External IDsandLatest Episodecases.
Fixed
- Spotlight Carousel Selectors (upstream drift) — the source site redesigned the
#hotestcarousel;homeInfo.extractor.jsandspotlight.extractor.jsupdated for the new markup (swiper-slidewithout.item,a.btn.btn-primaryinstead ofa.play,h2.ak-title,.ak-detaildetails). Old-layout selectors kept as fallbacks (dual-selector). Spotlight was returning 0 items before this fix; now returns 9. - Spotlight Rating — new layout packs rating into the
.ak-detaillist alongside year/date; numeric-with-decimal matching prevents years (e.g.2026) being mistaken for ratings (e.g.7.84). - Diagnostic Sweep — stale counts fixed across README badges,
docs/index.md,docs/endpoints.mdsample responses, landing-page meta/stat counter,docs/architecture.mdcontroller/extractor counts; render.yaml trailing newline added.
Changed
- Mirror Domains Synced — verified all mirrors against the official AniKoto domain hub (
https://anikoto.site/#domains); all 5 official domains return HTTP 200. Replaced deadanikoto.sewith officialanikototv.seindataUrl.js,render.yamland README domain tables. - Top Rankings —
?sort=day|week|monthconfirmed already supported by the extractor; docs matched, no code change needed. - Documentation Style — full repo-style pass on all new modules: box headers,
FEATUREmarkers, inlineNOTE/TIPmarkers, complete JSDoc, module footers; new sections indocs/endpoints.mdanddocs/streaming.md. - Dockerfile — base image
node:18-alpine→node:22-alpine(Node 18 is EOL; aligns with README's Node 20+ guidance).
Example
GET /api/stream/embeds?slug=one-piece-odmau&ep=1150
GET /api/stream/embeds?mal=21&ep=1&lang=dub&provider=megavid,megaplay
GET /api/info?id=one-piece-odmau
→ results.externalIds = { animeId: 1642, malId: "21", anilistId: 21 }
GET /api/episodes/latest?slug=one-piece-odmau
→ results.latest = { episode_no: 1180, server_ids: "...", mal_id: "21" }
Verified
- Full API suite: 38 passed / 0 failed / 2 optional skips (Servers + Stream Resolve — documented upstream AJAX blocks)
- 77 JS files pass
node --check; all relative imports resolve - All 3 embed provider URLs live-verified HTTP 200 (Megavid serves an embed-only page by design)
- Official domains all HTTP 200:
anikototv.to(primary),anikoto.cz,anikoto.me,anikoto.net,anikototv.se; deadanikoto.seconfirmed offline - No secrets tracked in git
Full changelog: see CHANGELOG.md
End-to-end endpoint reference: docs/endpoints.md