aniraws
API Aired today

API FAQ

Public endpoints

Public, read-only endpoints. No API key.

Feeds

  • /api — Newznab/Torznab API.
  • /rss2 — the public release stream as RSS 2.0.
  • /atom — the same stream as Atom.
GET /api?t=search&q=frieren&limit=50
GET /api?t=tvsearch&q=frieren&season=1&ep=4
GET /rss2?q=frieren&cat=5070

Feed parameters

/api, /rss2, and /atom accept these parameters.

  • q — every word must appear somewhere in the announced title, in any order, and one word must be 3 characters or longer. A whole BitTorrent v1 or v2 info hash returns that single release instead.
  • cat — 5070 (Anime), 2020 (Movies/Other), and their Newznab parents 5000 (TV) and 2000 (Movies). Any other category returns an empty feed.
  • limit — default 75, max 200.
  • offset — 0–1,000,000 for /api; 0–200 for RSS and Atom.
  • season, ep — narrow a TV search. Values that name no single number are ignored instead of failing the search.

JSON

/api/v1/feed returns the latest releases.

Unavailable values are returned as null.

  • /api/v1/feed?q=frieren — title search.
  • /api/v1/feed?limit=25 — release count; default 25, capped at 100.
  • /api/v1/feed?after_id=25 — continue after this ID in feed order. Unknown ID returns [].
  • /api/v1/feed?status=completed — exact stored release status.
  • /api/v1/feed?info_hash=62cf48adb6d8d95f2812c6de3906174e5374497f — v1/v2 hash.
  • /api/v1/feed?release_group_id=12 — release group ID.
  • /api/v1/feed?anidb_id=69 — AniDB ID.
  • /api/v1/feed?mal_id=1 — MyAnimeList ID.
  • /api/v1/feed?anilist_id=1 — AniList ID.
  • /api/v1/feed?episode_number=4 — exact parsed episode number.
  • /api/v1/feed?video_codec=HEVC — tasks containing an HEVC video.
  • /api/v1/feed?audio=ENG — tasks whose audio languages contain ENG.
  • /api/v1/feed?subtitles=ENG — tasks whose subtitle languages contain ENG.

Filters can be combined.

status accepts only pending, claimed, completed, failed, or skipped. Values ignore case and surrounding whitespace.

Invalid, repeated, and unsupported parameters return 400.

Usenet source NZBs

Some releases are imported from: Tsukihime or AnimeTosho-New, with a backlink to their release page.

Newznab/Torznab /api returns one NZB enclosure per result. It automatically expands over episodes inside per-file uploads, where applicable.

AniRaws — mostly not raws