Skip to content

tbdsux/kuryana

Repository files navigation

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

Deploy with Vercel

API Use

https://kuryana.vercel.app/search/q/{yourquery}
https://kuryana.vercel.app/id/{mydramalist-slug}
https://kuryana.vercel.app/id/{mydramalist-slug}/cast
https://kuryana.vercel.app/id/{mydramalist-slug}/reviews
https://kuryana.vercel.app/people/{people-id}
https://kuryana.vercel.app/seasonal/{year}/{quarter}
https://kuryana.vercel.app/list/{id}
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