API
Every guide in this section
- What It IsThe RandomTranslator API and connector: what they give a program or an AI assistant, who can use them (signed in, Reader membership and up), and what is never available.
- Get a KeyCreate a personal API key on your RandomTranslator account page (Reader membership, account a day old, up to three keys), keep it safe, revoke it, and how OAuth apps sign readers in instead.
- QuickstartYour first RandomTranslator API call with a personal key, in curl, Python and JavaScript, and what the answer and its headers look like.
- LimitsThe daily chapter allowance shared by the site, offline downloads, EPUB exports and RandomTranslator's apps, then API key units, connector calls and the other daily limits, the 429 answer, and how to ask for more.
- Conditional RequestsWhether the RandomTranslator API supports ETag and If-None-Match today, and how to avoid spending units on data that has not changed.
- How Answers Are ShapedThe conventions every RandomTranslator API answer follows: ids, titles in two languages, URLs, numbers and dates, list shapes, errors, and which fields are stable.
- API ReferenceEvery route of the RandomTranslator API: method and path, unit cost, freshness, permission, parameters, an example request with curl and a bearer key, a trimmed answer, and its errors.
- Paging and CapsHow lists are paged in the RandomTranslator API with skip and limit, the largest page each route allows, and what total means.
- Keeping in SyncThe cheap way for a tool to follow novels and a library on RandomTranslator, the feeds and sitemaps that exist, and how often each kind of data changes.
- CachingHow fresh RandomTranslator API answers are, why they carry no-store, how long a tool should keep what it fetched, and what the edge never caches.
- ErrorsEvery error the RandomTranslator API and connector answer: the HTTP status, the stable code, what it means and what to do next.
- VersioningWhat may change inside /api/v1 without notice, what would need a new version, how long an old version keeps working, and where changes are announced.
- Terms and Fair UseWhat you agree to when you create an API key or connect an app to RandomTranslator, in plain words.
- Use RandomTranslator in Claude, ChatGPT and Other AI AppsAdd RandomTranslator as a connector (MCP) in Claude, ChatGPT, Claude Code, Cursor or any MCP app, with exact steps and the URL, what it can do, its limits and what it can see.
- Connector ToolsEvery tool the RandomTranslator connector gives an AI assistant, with its inputs, what it answers, the permission it needs, its safety hints, and example questions.
- EPUB ExportExport a novel's translated chapters as an EPUB file from the site, the connector or the API. The plan, the export and its status, every outcome with its message, and the limits.
- For LLM ToolsThe OpenAPI document and llms.txt for agents and LLM tooling, and how to reach us about the API.