MyDramaList API

An unofficial, serverless web scraper API.
Designed for education, deployed on Vercel.

View API Reference View on GitHub

Base URL

Core Features

9 full-featured RESTful endpoints mapping MyDramaList. Built-in rate limiting limits strain on source.

Getting Started

Built with Python 3.12, FastAPI, and BeautifulSoup4. Setup local development in seconds.

Deployment

Deploy serverless on Vercel natively. Pre-configured vercel.json included for seamless CI/CD.

Success Response (200)

{
  "results":[
    {"title": "My Demon", "slug": "746993-my-demon"}
  ],
  "total": 1
}

Error Response (404)

{
  "code": 404,
  "error": true,
  "description": "404 Not Found"
}

Local Development Setup

Run the scraper locally using Uvicorn and FastAPI.

# 1. Clone the repository
git clone https://github.com/B1PL0B/MyDramaList-Unofficial-API.git
cd MyDramaList-Unofficial-API

# 2. Install dependencies
pip install -r requirements.txt

# 3. Run the development server
uvicorn main:app --reload

Vercel Deployment Guide

This API is optimized for serverless environments. If you intend to use this in production or heavily, please deploy your own instance to prevent rate limiting from shared IPs.

# 1. Install Vercel CLI
npm i -g vercel

# 2. Deploy (Auto-detects Python environment)
vercel --prod