animedex.entry.api.shikimori

animedex api shikimori subcommand.

api_shikimori

animedex.entry.api.shikimori.api_shikimori(*args: t.Any, **kwargs: t.Any) → t.Any

Issue a Shikimori REST or GraphQL request.

REST default: GET against /api/.... GraphQL: pass PATH= /api/graphql and --graphql 'query'; the wrapper sends a JSON body and defaults method to POST only when -X/--method is omitted. Both shikimori.io (canonical) and shikimori.one (fallback) serve identical data.

Docs:
  https://shikimori.io/api/doc                 REST v1/v2 reference
  https://shikimori.io/api/doc/graphql         GraphQL schema reference
  https://shikimori.io/api/doc/2.0             v2 reference (preferred)

Common REST paths:
  /api/animes/{id}                       fetch one anime
  /api/animes?search=Frieren&limit=2     search anime
  /api/mangas/{id}                       fetch one manga
  /api/mangas?search=Berserk&limit=2     search manga
  /api/ranobe/{id}                       fetch one ranobe
  /api/clubs/{id}                        fetch one club
  /api/publishers                        publisher taxonomy
  /api/people/{id}                       fetch one top-level person
  /api/calendar                          airing calendar
  /api/animes/{id}/screenshots           screenshot list
  /api/animes/{id}/videos                PV/OP/ED list

.. rubric:: Examples

animedex api shikimori /api/animes/52991 animedex api shikimori ‘/api/animes?search=Frieren&limit=2’ -i animedex api shikimori ‘/api/mangas?search=Berserk&limit=2’ animedex api shikimori /api/people/1870 animedex api shikimori /api/calendar animedex api shikimori /api/graphql –graphql ‘{ animes(ids:”52991”){ id name score } }’

Backend: Shikimori (shikimori.io; .one accepted fallback).

Rate limit: 5 RPS / 90 RPM.

— LLM Agent Guidance — For REST, leave PATH as e.g. /api/animes/{id}, /api/mangas/{id}, /api/ranobe/{id}, /api/clubs/{id}, /api/publishers, or /api/people/{id}. Prefer the high-level shikimori commands for lifted REST surfaces. For GraphQL, pass PATH=/api/graphql and –graphql ‘{ animes(…){ id } }’; the wrapper sends a JSON body, sets Content-Type: application/json, and defaults to POST only when the caller did not pass -X/–method. Both shikimori.io and shikimori.one serve identical data; .io is canonical. — End —