​
Overview

Fetches a paginated list of the TV Shows 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.getTVShows();

  console.log(JSON.stringify(result, null, 2));
}

main();

​
Response

response
{
  "page": 1,
  "totalPage": 121,
  "hasNextPage": true,
  "results": [
    {
      "id": "/dan-da-dan-season-2-19793",
      "image": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/4303d95c719242ab6e459d477b0a8c08.jpg",
      "title": "Dan Da Dan Season 2",
      "type": "TV",
      "language": {
        "sub": "7",
        "dub": "7"
      },
      "dataId": "19793"
    },
    {
      "id": "/kaiju-no-8-season-2-19792",
      "image": "https://cdn.noitatnemucod.net/thumbnail/300x400/100/8a3c3a24bc6aebc4b3c01ca82a5033ed.jpg",
      "title": "Kaiju No. 8 Season 2",
      "type": "TV",
      "language": {
        "sub": "5",
        "dub": "5"
      },
      "dataId": "19792"
    }
  ]
}

​
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.