Special Anime

Get the special anime list

Overview

Fetches a paginated list of the special anime as ranked on HiAnime. Use this when you need a broad, trending list to display on home pages, dashboards, or discovery screens.

Usage

index.ts

import { Hianime } from "hianime";

async function main() {
  const hianime = new Hianime();

  const result = await hianime.getSpecialList();
  console.log(JSON.stringify(result, null, 2));
}

main();

Response

response

{
  "page": 1,
  "totalPage": 23,
  "hasNextPage": true,
  "results": [
    {
      "id": "/one-piece-dr-choppers-adventure-checkup-good-friends-at-a-crossroad-19797",
      "image": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/6219a887344d14c4365d62cc0dd9502b.jpg",
      "title": "One Piece: Dr. Chopper's Adventure Checkup - Good Friends at a Crossroad",
      "type": "SPECIAL",
      "language": {
        "sub": "1",
        "dub": null
      },
      "dataId": "19797"
    },
    {
      "id": "/noble-farmer-2nd-season-specials-19701",
      "image": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/98bd6d2988234367100961d2e43e6df8.jpg",
      "title": "Noble Farmer 2nd Season Specials",
      "type": "SPECIAL",
      "language": {
        "sub": "2",
        "dub": null
      },
      "dataId": "19701"
    }
  ]
}

Response fields

• page: number — current page index returned by the API.
• totalPage: number — total number of pages available.
• hasNextPage: boolean — indicates whether another page is available.
• results: array of items containing:
  • id: string — anime identifier or path.
  • image: string — poster/thumbnail URL.
  • title: string — anime title.
  • type: string — e.g., “TV”, “Movie” (values depend on site data).
  • language.sub / language.dub: string — episode availability counts as reported by the site.
  • dataId: string — site-specific numeric identifier.

Parameters

• page: number — page to fetch. Defaults to 1. Must be a positive integer.
  Use page together with hasNextPage and totalPage to implement pagination in your app.

Notes & limitations

• Ordering and availability are determined by HiAnime and may change over time.
• Pagination limits (max pages) can vary; always check hasNextPage.
• This is an unofficial scraper-based method; site changes can break behavior without notice. Use responsibly and respect the website’s Terms of Service.