Skip to content

v2.5.1 — Embed Providers, Domain Sync & Latest-Episode Checker

Choose a tag to compare

@Shineii86 Shineii86 released this 13 Oct 01:58
· 6 commits to main since this release

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/embeds returning 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/info now includes externalIds: { animeId, malId, anilistId }, resolved server-side (60 min cache, best-effort: failed resolution returns nulls and never breaks the response). Feed the IDs straight into /api/stream/embeds.
  • Latest-Episode Checker — new GET /api/episodes/latest?slug= (new episodeLatest.controller.js): returns only the newest episode plus summary counts — built for bot polling and notification jobs. 10 min cache; registered before /episodes/:id so the literal path wins.
  • IDs Cache TTL — new TTL.ids (60 min) for MAL/AniList ID mappings (these never change per anime).
  • OpenAPI — /stream/embeds and /episodes/latest registered in the spec; /info summary notes the externalIds addition.
  • Tests — new Embed Providers, Embed (direct MAL), Info External IDs and Latest Episode cases.

Fixed

  • Spotlight Carousel Selectors (upstream drift) — the source site redesigned the #hotest carousel; homeInfo.extractor.js and spotlight.extractor.js updated for the new markup (swiper-slide without .item, a.btn.btn-primary instead of a.play, h2.ak-title, .ak-detail details). 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-detail list 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.md sample responses, landing-page meta/stat counter, docs/architecture.md controller/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 dead anikoto.se with official anikototv.se in dataUrl.js, render.yaml and README domain tables.
  • Top Rankings — ?sort=day|week|month confirmed already supported by the extractor; docs matched, no code change needed.
  • Documentation Style — full repo-style pass on all new modules: box headers, FEATURE markers, inline NOTE/TIP markers, complete JSDoc, module footers; new sections in docs/endpoints.md and docs/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; dead anikoto.se confirmed offline
  • No secrets tracked in git

Full changelog: see CHANGELOG.md
End-to-end endpoint reference: docs/endpoints.md