API Documentation
Totoro AI Pick API Docs
The Totoro app uses artificial intelligence to help users discover manga based on natural language queries. This document explains how that system works.
What is AI Pick?
AI Pick is a built-in feature that lets users describe what they want to read (for example, "action romance manhwa") and receive personalized manga suggestions from supported sources.
How It Works
Step 1: The user enters a natural language query in the AI Pick panel.
Step 2: The query is sent securely to the Groq API, employing the Llama language model.
Step 3: The AI parses the user input and maps it into structured data filters (genres, media type, serialization status).
Step 4: The Totoro client queries supported scanlation sources using these generated parameter filters.
Step 5: Results are consolidated, deduplicated, and rendered dynamically in the reader client.
Data Sent
- Only the text query entered by the user is sent to Groq.
- No personal information, device identifiers, or reading history is transmitted.
- Queries are processed securely via HTTPS.
Supported Sources
Currently, the AI Pick search parses and scans through these database backends:
- Comix
- MangaFire
- MangaDex
Rate Limits
To ensure fair usage and maintain quota health, AI search actions are subject to strict client-side rate limitations:
| Interval / Limit | Threshold Value | Objective |
|---|---|---|
| Minimum interval | 3 seconds |
Throttles consecutive search executions |
| Hourly limit | 20 queries |
Prevents API query flooding on Groq |
| Daily limit | 100 queries |
Prevents server-side quota depletion |
No User API Key Required
Totoro communicates using a developer-managed, proxy-routed API key. End users do not need to supply credentials or sign up for third-party developer integrations to utilize the AI Pick search.
Offline Behavior
If the device is offline or the AI server becomes unreachable, the client gracefully falls back to local keyword-based indexing across the same sources.
Privacy
See our Privacy Policy for details on how query data is handled.
Contact
For API-related questions or developer issues, please contact the developer.