animedex.api.danbooru

animedex api danbooru raw passthrough.

Backend: Danbooru (danbooru.donmai.us).

Rate limit: 10 req/sec global for reads.

— LLM Agent Guidance — UA mandatory: empty UA hits the Cloudflare challenge page (HTML). Default animedex/<version> passes. The tag DSL on /posts.json is the project’s most expressive query surface: positional tags include, -tag excludes, rating:g|s|q|e selects content class, score:>N / score:<N filter by score, order:score|date|random sets order. Pagination uses ?page=N&limit=M with cursor variants ?page=b<id> (before) and ?page=a<id> (after). Common read paths: /posts.json?tags=..., /posts/{id}.json, /tags.json?search[name_matches]=touhou*, /counts/posts.json?tags=.... The raw method argument is forwarded verbatim. — End —

call

animedex.api.danbooru.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 a Danbooru request and return its envelope.

selftest

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

Smoke-test the Danbooru passthrough.