API Reference
Best paired with traditional anime APIs for exact metadata and images: use traditional APIs (Jikan, AniList) for user watchlists and episode airing schedules, and pair with AAR for semantic search, thematic recommendations, and deep vector discovery.
Full specification for integrating Anime Akashic Records directly into your applications, AI agents,
and chatbots.
Free Public API Access & Per-IP Rate Limits
For evaluation, open-source AI agents, and independent developers, the complete AAR semantic retrieval engine is currently open for free testing through our direct tunnel gateway. No registration or credit card required.
https://download-equality-productions-arab.trycloudflare.com
aar_free_access
aar_free is also acceptedRetry-After/search)
Discovery
/ask)
AI Synthesis
aar_free_access / aar_free). RapidAPI subscribers and dedicated enterprise keys operate under separate tier allowances.
This promotional tier is hosted on shared experimental community infrastructure. While thoroughly optimized for sub-second responses, 100% uninterrupted uptime and peak latency are not unconditionally guaranteed during sudden concurrent traffic surges.
Gateway: anime-akashic-records-aar-api.p.rapidapi.com
X-RapidAPI-Key.
Send it with every request as an HTTP header. Free and paid quota tiers are available.
Anime Akashic Records (AAR) is purpose-built for semantic retrieval, trope discovery, natural language query resolution, production metadata filtering, and grounded AI answer synthesis across 144,000+ indexed canonical works and 444,000+ interconnected entities (characters, voice actors, directors, authors, composers, and work-to-work relationships). While deep production metadata is fully indexed and filterable in every payload, AAR is not designed as a real-time minute-by-minute episode airing tracker or personal watch-list manager.
Endpoints
Advanced Hybrid Retrieval
The primary discovery endpoint. Blends dense semantic vector embeddings with lexical keyword matching and neural reranking. Returns ranked works paired with confirming excerpts.
AAR is engineered to serve real-time user-facing search and automated agents at maximum velocity:
query_breakdown: false)Sub-second speed (~500ms). Native hybrid pipeline fusing ScaNN-cascade dense vectors (Qdrant int8), FTS5 BM25, in-memory character synergy aggregation, and deep Cross-Encoder reranking without any LLM delay. Active by default for all requests.
query_breakdown: true)
Compound Query Decomposition. Pass "query_breakdown": true in your request body when you want an LLM to decompose complex multi-part comparative queries (e.g. "anime like Cowboy Bebop with themes like Psycho-Pass") into targeted sub-probes before retrieval (adds ~400–800ms).
Request Parameters
8, max: 50) — Maximum number of works to return."hybrid") — "hybrid" for balanced keywords & concepts; "semantic" for vector-only retrieval.false) — Default is false for ultra-low-latency native hybrid retrieval (~500ms) without LLM query rewriting delay. Pass true only when you want an LLM to decompose complex multi-part or comparative queries (e.g. "anime like X but with themes like Y") into targeted sub-probes before retrieval (adds ~400–800ms).false) — Explicitly marks query as adult/NSFW, skipping LLM query refinement and proceeding directly to vector embedding.["staff", "characters", "relations"].Example Request (GET — Recommended)
curl -X GET "https://download-equality-productions-arab.trycloudflare.com/search?q=Bounty+hunters+across+the+solar+system+with+bebop+jazz+soundtrack&limit=5&mode=hybrid&include=staff,characters,relations&type=anime" \
-H "x-api-key: aar_free_access"Example Request (POST — JSON Payload)
curl -X POST "https://download-equality-productions-arab.trycloudflare.com/search" \
-H "Content-Type: application/json" \
-H "x-api-key: aar_free_access" \
-d '{
"question": "Bounty hunters across the solar system with bebop jazz soundtrack",
"limit": 5,
"mode": "hybrid",
"query_breakdown": true,
"include": ["staff", "characters", "relations"],
"scope": {
"types": ["anime"],
"director_names": ["Shinichirou Watanabe"],
"composer_names": ["Yoko Kanno"]
}
}'Example Response (200 OK)
{
"total": 1,
"total_documents": 1,
"results": [
{
"work_id": "work:anime:mal_1_al_1",
"title": "Cowboy Bebop",
"title_english": "Cowboy Bebop",
"title_romaji": "Cowboy Bebop",
"title_native": "カウボーイビバップ",
"type": "anime",
"bucket": "anime",
"status": "finished",
"score": 0.9624,
"community_score": 87.5,
"popularity": 43,
"release_year": 1998,
"genres": ["Action", "Sci-Fi", "Adult Cast", "Space"],
"themes": ["Space Noir", "Bounty Hunters"],
"studios": ["Sunrise", "Bandai Visual"],
"description": "In the year 2071, humanity has colonized several planets and moons in the solar system, leaving the surface of Earth behind. Spike Spiegel and Jet Black lead a crew of bounty hunters aboard the spaceship Bebop...",
"image_url": "https://cdn.myanimelist.net/images/anime/4/19644.jpg",
"url": "https://myanimelist.net/anime/1/Cowboy_Bebop",
"mal_id": 1,
"anilist_id": 1,
"vndb_id": null,
"is_adult": false,
"chunks": [
{
"chunk_id": "chunk:anime:1:synopsis:0",
"section": "Synopsis",
"text": "In the year 2071, humanity has colonized several planets and moons in the solar system, leaving the surface of Earth behind. Spike Spiegel and Jet Black lead a crew of bounty hunters aboard the spaceship Bebop..."
}
]
}
]
}Question Answering
Conversational endpoint tailored for chatbots and AI agents. Synthesizes a grounded, factual natural-language prose answer derived strictly from retrieved canonical catalog records, production staff, and franchise relations.
Request Parameters
8) — Maximum reference works to retrieve for synthesis."hybrid") — "hybrid" or "semantic" retrieval mode.true) — When true, uses LLM query refinement. When false, embeds the query directly as-is to minimize latency.false) — Explicitly marks query as adult/NSFW, skipping LLM query refinement and proceeding directly to vector embedding.["staff", "characters", "relations"].Example Request (GET — Recommended)
curl -X GET "https://download-equality-productions-arab.trycloudflare.com/ask?q=What+anime+adaptations+exist+for+Steins+Gate+who+directed+the+2011+series&limit=5&type=anime" \
-H "x-api-key: aar_free_access"Example Request (POST — JSON Payload)
curl -X POST "https://download-equality-productions-arab.trycloudflare.com/ask" \
-H "Content-Type: application/json" \
-H "x-api-key: aar_free_access" \
-d '{
"question": "What anime adaptations exist for Steins;Gate, who directed the 2011 series, and which studio produced it?",
"limit": 5,
"query_breakdown": true,
"scope": {
"types": ["anime"]
}
}'Example Response (200 OK)
{
"answer": "The television anime adaptation of Steins;Gate was produced by studio White Fox and co-directed by Hiroshi Hamasaki and Takuya Satou, airing in 2011 across 24 episodes. The franchise also includes the alternate timeline sequel anime Steins;Gate 0 (2018), the theatrical film Steins;Gate: The Movie − Load Region of Déjà Vu (2013), and the Soumei Kousoku no Cognitive Computing ONA series.",
"sources": ["work:anime:mal_9253_al_9253"],
"used_citations": ["chunk:anime:9253:synopsis:0"],
"total": 1,
"total_documents": 1,
"results": [
{
"work_id": "work:anime:mal_9253_al_9253",
"title": "Steins;Gate",
"title_english": "Steins;Gate",
"type": "anime",
"bucket": "anime",
"status": "finished",
"score": 0.9540,
"community_score": 90.7,
"release_year": 2011,
"genres": ["Drama", "Sci-Fi", "Suspense", "Time Travel"],
"studios": ["White Fox"],
"description": "Self-proclaimed mad scientist Rintaro Okabe rents out a room in a rickety old building in Akihabara, where he invents 'future gadgets' with fellow lab members...",
"image_url": "https://cdn.myanimelist.net/images/anime/1935/127974.jpg",
"url": "https://myanimelist.net/anime/9253/Steins_Gate",
"mal_id": 9253,
"anilist_id": 9253,
"is_adult": false,
"chunks": [
{
"section": "Synopsis",
"text": "Self-proclaimed mad scientist Rintaro Okabe rents out a room in a rickety old building in Akihabara, where he invents 'future gadgets' with fellow lab members..."
}
]
}
]
}Liveness Probe & Corpus Statistics
Lightweight health check and catalog statistics endpoint. Requires an API key header (such as x-api-key: aar_free_access), but does not consume request quota (quota-free). Safe for uptime monitors, container liveness checks, and integration smoke tests.
Example Request
curl -X GET "https://download-equality-productions-arab.trycloudflare.com/health" \
-H "x-api-key: aar_free_access"Example Response (200 OK)
{
"status": "ok",
"works": 144,025,
"chunks": 157340
}Work-to-Work Semantic Recommendation
Discover titles with matching narrative DNA, emotional tone, and thematic essence to any specified work. Unlike superficial genre checkboxes, this endpoint computes deep vector proximity across plot complexity, character dynamics, and aesthetic pacing.
Request Parameters
["work:anime:mal_9253_al_9253"])./recommend/work:anime:mal_9253_al_9253)."anime", "manga", etc.10, max: 50) — Number of recommended titles to return.Example Request (GET)
curl -X GET "https://download-equality-productions-arab.trycloudflare.com/recommend/work:anime:mal_9253_al_9253?limit=5" -H "x-api-key: aar_free_access"Example Request (POST — JSON Payload)
curl -X POST "https://download-equality-productions-arab.trycloudflare.com/recommend" -H "Content-Type: application/json" -H "x-api-key: aar_free_access" -d '{
"seed_work_ids": ["work:anime:mal_9253_al_9253"],
"limit": 5
}'Example Response (200 OK)
{
"work_id": "work:anime:mal_9253_al_9253",
"title": "Steins;Gate",
"total_recommendations": 5,
"recommendations": [
{
"position": 1,
"work_id": "work:anime:mal_30484_al_21127",
"title": "Steins;Gate 0",
"type": "anime",
"similarity_score": 0.9412
},
{
"position": 2,
"work_id": "work:anime:mal_22535_al_20665",
"title": "Kiseijuu: Sei no Kakuritsu",
"type": "anime",
"similarity_score": 0.8125
}
]
}Community Suggestions & Catalog Contributions
Propose brand-new anime, manga, or light novels, suggest custom narrative descriptions, or recommend metadata corrections. Submissions are automatically clustered and aggregated for catalog updates.
Whether proposing missing titles, providing rich narrative plot descriptions, or suggesting corrections to existing works: we actively welcome community and AI agent contributions through this endpoint. All submissions are automatically clustered, deduplicated, and reviewed for inclusion in canonical catalog updates.
Request Parameters (POST /suggest or /contributions)
"ADD_WORK", "ADD_ALIAS", "EDIT_METADATA", "FEATURE_OR_VIBE"."anime", "manga", "light_novel", "visual_novel", "manhwa", "manhua".2024).Example Request (POST /suggest)
curl -X POST "https://download-equality-productions-arab.trycloudflare.com/suggest" -H "Content-Type: application/json" -H "x-api-key: aar_free_access" -d '{
"contribution_type": "ADD_WORK",
"media_type": "anime",
"title": "Sousou no Frieren",
"custom_description": "An elf mage embarks on a peaceful, decades-long journey across the lands where she once defeated the Demon King, reflecting on the fleeting nature of human life and the bonds forged along the way.",
"alt_titles": ["Frieren: Beyond Journey's End"],
"author": "Kanehito Yamada",
"release_year": 2023,
"suggested_tags": ["Fantasy", "Adventure", "Slice of Life", "Drama"]
}'Inspecting Clustered Submissions (GET /contributions/grouped)
Retrieve the aggregated view of all community proposals clustered by work:
curl -X GET "https://download-equality-productions-arab.trycloudflare.com/contributions/grouped" -H "x-api-key: aar_free_access"Scope Filter Fields
Hard filters supplied under the scope object. Unrecognized fields are strictly rejected with 422 so configuration mistakes are caught immediately. All staff and character filters support canonical romanizations and case-insensitive matching.
Production, Staff & Entity Filters
["Shinichirou Watanabe", "Akiyuki Shinbou", "Hideaki Anno"])["Nisio Isin", "Kentarou Miura", "Naoki Urasawa"])["Yoko Kanno", "Hiroyuki Sawano", "Yuki Kajiura", "Satoru Kousaki"])["Hiroshi Kamiya", "Chiwa Saitou", "Mamoru Miyano", "Megumi Hayashibara"])["Shinobu Oshino", "Rintaro Okabe", "Spike Spiegel"])["Cowboy Bebop", "Steins;Gate"])Medium, Genre & Catalog Attributes
["Action", "Sci-Fi", "Mystery", "Psychological"])["Time Travel", "Cyberpunk", "Space", "Noir", "Post-Apocalyptic"])["ufotable", "Madhouse", "Bones", "Shaft", "White Fox"])1998, 2024)[1998, 2011])0.0 to 10.0, e.g. 8.5)false excludes 18+ content; true returns only adult works)The include Relational Parameter
By default, retrieval payloads return canonical metadata and text chunks. Pass the include array in your request to hydrate rich relational sub-trees:
MAIN, SUPPORTING), and assigned voice actors.