# AnimeDoc

> AnimeDoc is an anime and movie streaming API with search, details and playback endpoints, plus a free site to watch anime online.

AnimeDoc (https://animedoc.cloud) is built by ResBrotherX. Developers call the REST API at https://api.animedoc.cloud with an API key — every catalog endpoint requires one. Viewers can watch anime and movies on the website itself (3 free videos as a guest, then a free account to keep watching). Content comes from licensed content providers, and the catalog can change.

## API basics

- Base URL: https://api.animedoc.cloud
- Auth: send your API key in the `X-API-Key` header. Get a free key at https://animedoc.cloud/docs/pricing.
- Responses are JSON wrapped in {"code": 0, "message": "ok", "data": {...}}.
- Rate limits: each plan has requests per day (reset 00:00 UTC) and per minute. Over a limit returns HTTP 429 with a Retry-After header and {"error": "rate_limit_exceeded" | "daily_quota_exceeded"}. Headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
- OpenAPI spec: https://animedoc.cloud/openapi.json
- Full reference in one file (all parameters, examples and errors): https://animedoc.cloud/llms-full.txt
- Endpoint index (no key needed): https://api.animedoc.cloud/api/v2/

## Endpoints

- GET /api/v2/anime/home/ — Home Feed: Everything a streaming front page needs in one call: banners and ready-made catalog rows. Docs: https://animedoc.cloud/docs/endpoints/home
- GET /api/v2/anime/section/ — Section: A ready-made page for one section (anime, movies, series, asian, bollywood, nollywood), or that section's filtered list. Docs: https://animedoc.cloud/docs/endpoints/section
- GET /api/v2/anime/trending/ — Trending: What most people are watching right now, across anime, movies and series. Docs: https://animedoc.cloud/docs/endpoints/trending
- GET /api/v2/anime/browse/ — Browse: List a channel (movies, series or animation) sorted by latest, most popular or top rated, optionally by genre and country. Docs: https://animedoc.cloud/docs/endpoints/browse
- POST /api/v2/anime/suggest/ — Search Suggestions: Autocomplete: turn a partial keyword into likely search terms. Docs: https://animedoc.cloud/docs/endpoints/search-suggestions
- POST /api/v2/anime/search/ — Search: Full-text catalog search across anime, animation, movies and series, with pagination. Docs: https://animedoc.cloud/docs/endpoints/search
- GET /api/v2/anime/detail/ — Details: Full metadata for one title, plus its seasons and episode counts. Docs: https://animedoc.cloud/docs/endpoints/details
- GET /api/v2/anime/media-sources/ — Media Sources: Playable video URLs (several resolutions) and subtitle tracks for one episode or movie. Docs: https://animedoc.cloud/docs/endpoints/media-sources
- GET /api/v2/anime/stream-file/ — Stream Proxy: Streams a Media Sources URL back through AnimeDoc, with byte-range support, so players can seek. Docs: https://animedoc.cloud/docs/endpoints/stream-proxy

Typical flow: Home Feed / Trending / Browse / Search (find titles) -> Details (seasons and episode counts) -> Media Sources (video URLs + subtitles) -> Stream Proxy (playback with seeking).

## Plans (USD; signed-in users are shown and charged the equivalent in their own currency)

- Free: $0. 20 requests/day, 10 requests/minute. Search, details and media sources; No credit card; "Powered by AnimeDoc" credit required.
- Starter: $12/month or $60 for 6 months. 3,000 requests/day, 60 requests/minute. All endpoints, including stream proxy; Email support; Personal / hobby use.
- Pro: $22/month or $110 for 6 months. 20,000 requests/day, 300 requests/minute. All endpoints; Commercial use; Priority support; Usage dashboard.
- Business: from $100/month. 500,000+ requests/day, custom requests/minute. All endpoints; Commercial use; SLA; Dedicated support.
- 3-Day Pass: $1 one-time, 2,000 requests/day for 3 days.
- One API key per account on every plan. Six months costs the same as five. No auto-renewal; when a plan ends the key keeps working on Free limits.
- The Free plan covers search, details and media sources; the stream proxy needs a paid plan. Free plan users must show "Powered by AnimeDoc".

## Key pages

- [Anime streaming API](https://animedoc.cloud/anime-streaming-api): AnimeDoc is an anime streaming API: search anime and movies, get details and episode lists, and resolve playable sources with a stream proxy. Free API key, from $12/month.
- [Pricing](https://animedoc.cloud/pricing): plans, limits, comparison table and pricing FAQ.
- [AnimeDoc API documentation](https://animedoc.cloud/docs): Reference for the AnimeDoc anime API: authentication with an API key, search, details, media sources and stream proxy endpoints, error codes and rate limits per plan.
- [Rate limits](https://animedoc.cloud/docs/rate-limits): AnimeDoc API rate limits per plan: requests per day and per minute, X-RateLimit headers, 429 responses with Retry-After, and the daily reset at 00:00 UTC.
- [The best anime API for your project](https://animedoc.cloud/best-anime-api): A practical guide to anime APIs: Jikan, AniList and Kitsu for anime metadata, AnimeDoc for anime streaming. What each does, limits, cost, and when to use which.
- [A Consumet alternative for anime streaming](https://animedoc.cloud/consumet-alternative): Looking for a Consumet alternative? Compare Consumet's self-hosted scraper approach with AnimeDoc's hosted anime streaming API: API keys, documented limits and a free plan.
- [An AniAPI alternative](https://animedoc.cloud/aniapi-alternative): AniAPI has been discontinued. Compare the options that replaced it: Jikan, AniList and Kitsu for anime metadata, and AnimeDoc for anime search and streaming.
- [Build an anime streaming app with React](https://animedoc.cloud/tutorials/build-anime-streaming-app-react): Step-by-step tutorial: build an anime streaming app in React with the AnimeDoc anime API — search, episode picker and a video player, with a small Node proxy for your API key.
- [Build a React Native anime app](https://animedoc.cloud/tutorials/react-native-anime-app): Tutorial: a React Native (Expo) anime app with search and a video player using the AnimeDoc anime streaming API and expo-video. Full working code.
- [Build an anime Discord bot](https://animedoc.cloud/tutorials/anime-discord-bot): Tutorial: an anime Discord bot with discord.js v14 and the AnimeDoc anime API — a /anime slash command that searches and shows results as embeds. Full working code.
- [Build an anime Telegram bot](https://animedoc.cloud/tutorials/anime-telegram-bot): Tutorial: an anime Telegram bot in Python that searches anime and lists episodes with the AnimeDoc anime API and python-telegram-bot. Full working code.
- [Watch anime online free](https://animedoc.cloud/watch): Watch anime, movies, K-dramas, Bollywood and Nollywood online on AnimeDoc: trailers, continue watching, quality selection and auto-next episodes. 3 free videos, then a free account to keep watching.
- [Frequently asked questions](https://animedoc.cloud/faq): Short answers about AnimeDoc: is there a free anime streaming API, the best Consumet alternative, using it in Discord and Telegram bots, pricing, rate limits and watching anime free.
- [About AnimeDoc](https://animedoc.cloud/about): About AnimeDoc, the anime and movie streaming API and free anime streaming site, built by ResBrotherX. Licensed content, contact details and what we're building.
- [Status](https://animedoc.cloud/status): live API status.

## Contact

support@animedoc.cloud