# AniListCal

AniListCal is a personal airing desk on top of AniList. It is not affiliated with AniList. The public catalog — what is airing, seasonal shelves, search, and show, character, and staff pages — can be read without an account. A viewer's list, episode progress, profile, and recommendations require that person to sign in with AniList in a browser.

## Public pages

These URLs include the facts in the HTML response. `:id` is the AniList id, the same number anilist.co uses.

- https://anilistcal.com/ — today's public airings and seasonal shelves
- https://anilistcal.com/calendar — the public airing schedule for the next seven days
- https://anilistcal.com/season/current and https://anilistcal.com/season/upcoming — the seasonal catalog
- https://anilistcal.com/search?q= — search by name
- https://anilistcal.com/show/:id — title, format, season, episode count, synopsis, and next air time
- https://anilistcal.com/character/:id — name and description
- https://anilistcal.com/staff/:id — name and description
- https://anilistcal.com/privacy — how sign-in and data use work

## Schedule

The today file is only the current UTC date. The week file groups the seven UTC dates that start at midnight today.

- https://anilistcal.com/airing/today.md — every episode airing on the current UTC date
- https://anilistcal.com/airing/week.md — episodes grouped by UTC date for the seven days starting today

## Public JSON

GET requests, cached, and limited to the same public reads as the site. They do not include list status or progress.

- https://anilistcal.com/api/public/media/:id
- https://anilistcal.com/api/public/search?q=
- https://anilistcal.com/api/public/season/current
- https://anilistcal.com/api/public/season/upcoming
- https://anilistcal.com/api/public/season/:year/:season — season is winter, spring, summer, or fall
- https://anilistcal.com/api/public/airing?from=&to= — unix seconds; only a window around now, at most about eight days. Omit both for the current week.
- https://anilistcal.com/api/public/character/:id
- https://anilistcal.com/api/public/staff/:id

## Requires a browser session

List, progress, scores, profile, and recommendations are available only after the user completes AniList OAuth in a browser. Do not send GraphQL to /api/anilist/proxy. Do not scrape account data. POST /api/recommend/chat is not a public API.

See https://anilistcal.com/privacy and https://anilistcal.com/sitemap.xml.