animedex.api.ann

animedex api ann raw passthrough.

Backend: ANN Encyclopedia (cdn.animenewsnetwork.com).

Rate limit: 1 req/sec/IP on the default endpoint (queues over-budget requests rather than 4xx-ing); 5 reqs/5sec on the nodelay.api.xml variant which 503s on overshoot.

— LLM Agent Guidance — XML responses. The api.xml endpoint accepts:

  • ?anime={id} - fetch by id (id space independent of MAL/AniList).

  • ?anime=~<substring> - substring search by title (this is the real fuzzy search; ?title=... is for id aliasing only).

  • ?title=<id> - id alias resolution.

A 200 response with <warning>no result for ...</warning> is the empty-result indicator; the call is not an error per se. Reports endpoint at reports.xml.

Attribution policy (informational): consumers should display “source: Anime News Network” plus a backlink to the ANN entry. — End —

call

animedex.api.ann.call(path: str, *, method: str = 'GET', headers: Dict[str, str] | None = None, params: dict | None = None, no_cache: bool = False, cache_ttl: int | None = None, rate: str = 'normal', follow_redirects: bool = True, user_agent: str | None = None, timeout_seconds: float | None = None, cache=None, session=None, rate_limit_registry=None, config=None) RawResponse[source]

Issue an ANN request and return its envelope.

selftest

animedex.api.ann.selftest() bool[source]

Smoke-test the ANN passthrough.