tbdsux / kuryana

A serverless web scraper api for MyDramaList.com

kuryana

A simple MyDramaList.com scraper api.

This scrapes on the go so it might be slow.

THIS SERVICE IS ONLY CREATED TO SATISFY THE NEED FOR AN API FOR [MYDRAMALIST.COM](https://mydramalist.com). THIS WILL BE STOPPED ONCE AN OFFICIAL API WILL BE RELEASED.

Deploy Your Own

API Use

• Search for dramas

https://kuryana.vercel.app/search/q/{yourquery}

• Get DRAMA Info

https://kuryana.vercel.app/id/{mydramalist-slug}

• Get DRAMA Cast

https://kuryana.vercel.app/id/{mydramalist-slug}/cast

• Get DRAMA Reviews

https://kuryana.vercel.app/id/{mydramalist-slug}/reviews

• Get Person(People) Info

https://kuryana.vercel.app/people/{people-id}

• Get seasonal drama

https://kuryana.vercel.app/seasonal/{year}/{quarter}

• Get Lists

https://kuryana.vercel.app/list/{id}

• Get User Dramalist

https://kuryana.vercel.app/dramalist/{user_id}

Error Messages

// mainly on all endpoints except `search`
// sample: /list/unknown-random-id
{
  "code": 400,
  "error": true,
  "description": {
    "title": "This list is private.",
    "info": "You can see this page because the URL you are accessing cannot be found."
  }
}

// could also be this (only on `/search`) endpoint
{
  "error": true,
  "code": 404,
  "description": "404 Not Found"
}

Development

• Minimum Python Version : 3.9,

• Always make sure to create a virtualenvironment

  python -m venv venv
  source ./venv/bin/activate.sh # change depends on your shell and os

• Install the dependencies

  pip install -r requirements.txt

Dev Server

You can start the development server in two ways:

• Using the vercel CLI (localhost:3000)

  vercel dev

  • The api will be http://localhost:3000/api/*

• Or with uvicorn (localhost:8000)

  uvicorn api.main:app --reload

  • The api will be http://localhost:8000/*

NOTE

All Requests and SCRAPED Datas are not cached by Vercel or the API itself.

© TheBoringDude