MyDramaList API

https://mydramalist.github.io/MDL-API/
Admin
MyDramaList API provides programmatic access to TV shows, movies, dramas, and watchlist data,...
Tokens:11,985
Snippets:44
Trust Score:9.7
Update:6 months ago
Show doc for...
Tokens:
Raw
### GET /v1/titles/updates/[START_DATE]

Source: https://mydramalist.github.io/MDL-API

Fetches a list of TV shows or movies that have been recently updated, based on a start date.

```APIDOC
## Get recently updates

### Description
Retrieves a list of recently updated TV shows or movies.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/titles/updates/[START_DATE]`

### Parameters
#### Path Parameters
- **START_DATE** (string) - Required - The date from which to retrieve updates (e.g., `2019-04-02`).

#### Headers
- **Content-Type**: application/json
- **mdl-api-key**: [client_id] - Your API key.

### Response
#### Success Response (200)
Returns an array of objects, each containing the ID and title of a recently updated item, along with the update timestamp.

#### Response Example
```json
[
  {
    "id": 1988,
    "title": "Tenkosei: Sayonara Anata",
    "updated_at": "2019-04-01T09:50:10Z"
  },
  {
    "id": 7703,
    "title": "Houkago",
    "updated_at": "2019-04-01T09:50:14Z"
  },
  {
    "id": 16169,
    "title": "Morrasoom Sawat",
    "updated_at": "2019-04-01T09:50:27Z"
  }
]
```
```

--------------------------------

### Get recently updated titles

Source: https://mydramalist.github.io/MDL-API

Retrieves a list of titles updated since the specified start date.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/titles/updates/[START_DATE] \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
[
  {
    "id": 1988,
    "title": "Tenkosei: Sayonara Anata",
    "updated_at": "2019-04-01T09:50:10Z"
  },
  {
    "id": 7703,
    "title": "Houkago",
    "updated_at": "2019-04-01T09:50:14Z"
  },
  {
    "id": 16169,
    "title": "Morrasoom Sawat",
    "updated_at": "2019-04-01T09:50:27Z"
  }
]
```

--------------------------------

### Get Genres

Source: https://mydramalist.github.io/MDL-API

Retrieves a list of all available genres.

```APIDOC
## Get Genres

### Description
Retrieves a list of all available genres.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/genres`

### Response
#### Success Response (200)
- **genres** (array) - A list of genre objects.
  - **id** (integer) - The genre ID.
  - **name** (string) - The genre name.

#### Response Example
```json
{
  "genres": [
    {
      "id": 1,
      "name": "Action"
    },
    {
      "id": 2,
      "name": "Comedy"
    }
  ]
}
```
```

--------------------------------

### Get User Settings

Source: https://mydramalist.github.io/MDL-API

Retrieves the current user's settings.

```APIDOC
## Get user settings

### Description
Retrieves the current user's settings.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/users/settings`

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **settings** (object) - User settings object.

#### Response Example
```json
{
  "settings": {
    "theme": "dark",
    "notifications": true
  }
}
```
```

--------------------------------

### Get Review Details

Source: https://mydramalist.github.io/MDL-API

Fetch a specific review by its ID. Requires an MDL API key.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/reviews/[ID] \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

--------------------------------

### Get all reviews for a title

Source: https://mydramalist.github.io/MDL-API

Retrieves a list of reviews for a specific title using its ID. Requires the mdl-api-key header.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/titles/[id]/reviews \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
[
  {
    "id": 47125,
    "ratings": {
      "story": 7,
      "acting": 8.5,
      "music": 8.5,
      "rewatch": 8.5,
      "overall": 8.5
    },
    "headline": "",
    "review": "Pellentesque dapibus hendrerit tortor. Maecenas ullamcorper...",
    "version": 4,
    "upvotes": 0,
    "total_votes": 0,
    "completed": true,
    "dropped": false,
    "spoiler": false,
    "lang_iso": "en-US",
    "comments": 19,
    "voted": 0,
    "episodes": 1,
    "episodes_seen": 1,
    "author": {
      "username": "Dummy",
      "display_name": "Dummy",
      "avatar_url": "..."
    },
    "title": {
      "id": 24640,
      "slug": "/24640-test-content",
      "title": "Test Content",
      "type": "Movie",
      "year": 2018,
      "images": {
        "thumb": "...",
        "medium": "...",
        "poster": "..."
      }
    },
    "created_at": "2019-05-13T08:09:55Z"
  }
]
```

--------------------------------

### GET /v1/reviews/[ID]

Source: https://mydramalist.github.io/MDL-API

Retrieves detailed information about a specific review by its ID.

```APIDOC
## GET /v1/reviews/[ID]

### Description
Get a review details by ID.

### Method
GET

### Endpoint
https://api.mydramalist.com/v1/reviews/[ID]

### Parameters
#### Path Parameters
- **ID** (string) - Required - The unique identifier of the review.

### Response
#### Success Response (200)
- **id** (integer) - Review ID.
- **ratings** (object) - Ratings breakdown.
- **headline** (string) - Review headline.
- **review** (string) - Review content.

#### Response Example
{
  "id": 40016,
  "ratings": {
    "story": 9.5,
    "acting": 9,
    "music": 9,
    "rewatch": 9.5,
    "overall": 9
  },
  "headline": "Amazing drama!",
  "review": "Nullam tincidunt adipiscing enim..."
}
```

--------------------------------

### Get person details

Source: https://mydramalist.github.io/MDL-API

Retrieves primary details for a person by their unique ID.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/people/[ID] \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
{
  "id": 972,
  "name": "Im Yoon Ah",
  "first_name": "Yoon Ah",
  "family_name": "Im",
  "original_name": "임윤아",
  "biography": "Im Yoon Ah, commonly stylized as Yoona, is a popular South Korean pop singer, dancer, actress, model and spokesmodel. She is a member of the Korean girl group Girls' Generation and is known as the center-girl, lead dancer and sub-vocalist of the group. Yoona made her debut as a singer along with Girls' Generation on August 5, 2007. She made her debut as an actress in the 2007 Korean drama, 9 Ends, 2 Outs. \nIn January 2014, Yoona and actor Lee Seung Gi were confirmed to be in a relationship since September 2013. On the 13 of August 2015, both stars confirmed they broke up after dating for a year and nine months due to busy schedules.",
  "permalink": "https://mydramalistcom/people/972-im-yoon-ah",
  "slug": "people/972-im-yoon-ah",
  "birthday": "1990-05-30",
  "dod": "0000-00-00",
  "nationality": "South Korean",
  "thumbnail": "",
  "images": {
    "thumb": "...",
    "medium": "...",
    "poster": "..."
  }
}
```

--------------------------------

### Get watchlist via cURL

Source: https://mydramalist.github.io/MDL-API

Retrieves the user's watchlist for a specific type.

```bash
curl "https://api.mydramalist.com/v1/sync/mylist/[TYPE]" \
  -H "Content-Type: application/json" \
  -H "mdl-api-key: [client_id]"
```

```json
[
  {
    "list_id": 1,
    "episode_seen": 3,
    "rating": 0,
    "priority": 0,
    "times_rewatched": 0,
    "rewatch_value": 0,
    "date_start": "0000-00-00",
    "date_finish": "0000-00-00",
    "note": "testing2",
    "tags": "",
    "updated_at": "2019-04-04T06:29:03Z",
    "title": {
      "id": 25172,
      "title": "My Mister",
      "original_title": "나의 아저씨",
      "year": 2018,
      "episodes": 16,
      "rating": 9.2,
      "released": true,
      "ended": true,
      "type": "Drama",
      "country": "South Korea",
      "language": "Korean",
      "images": {
        "thumb": "...",
        "medium": "...",
        "poster": "..."
      }
    }
  }
]
```

--------------------------------

### Get related titles

Source: https://mydramalist.github.io/MDL-API

Fetches a list of related titles for a given drama or movie ID.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/titles/[id]/related \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
[
  {
    "id": 50319,
    "title": "Unknown Number",
    "original_title": "时空来电",
    "year": 2019,
    "rating": 9.1,
    "permalink": "/50319-unknown-number",
    "type": "Drama",
    "language": "Chinese",
    "related_type": "Remake",
    "images": {
      "thumb": "...",
      "medium": "...",
      "poster": "..."
    }
  }
]
```

--------------------------------

### Get Watchlist

Source: https://mydramalist.github.io/MDL-API

Retrieves a user's watchlist based on the specified type.

```APIDOC
## Get Watchlist

### Description
Retrieves a user's watchlist based on the specified type.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/sync/mylist/[TYPE]`

### Path Parameters
- **TYPE** (string) - Required - The type of the watchlist. Supported types: `watchlist`, `completed`, `plantowatch`, `dropped`, `onhold`, `notinterested`.

### Response
#### Success Response (200)
- **watchlist** (array) - A list of items in the user's watchlist.
  - **list_id** (integer) - The ID of the item in the list.
  - **episode_seen** (integer) - Number of episodes seen.
  - **rating** (float) - User's rating for the item.
  - **priority** (integer) - Priority of the item.
  - **times_rewatched** (integer) - Number of times rewatched.
  - **rewatch_value** (integer) - Rewatch value.
  - **date_start** (date) - Start date of watching.
  - **date_finish** (date) - Finish date of watching.
  - **note** (string) - User's notes.
  - **tags** (string) - Tags associated with the item.
  - **updated_at** (datetime) - Timestamp of the last update.
  - **title** (object) - Details of the title.
    - **id** (integer) - Title ID.
    - **title** (string) - Title of the drama/movie.
    - **original_title** (string) - Original title.
    - **year** (integer) - Release year.
    - **episodes** (integer) - Number of episodes.
    - **rating** (float) - Average rating.
    - **released** (boolean) - Whether the title has been released.
    - **ended** (boolean) - Whether the title has ended.
    - **type** (string) - Type of the title (e.g., Drama, Movie).
    - **country** (string) - Country of origin.
    - **language** (string) - Original language.
    - **images** (object) - Image URLs.
      - **thumb** (string) - Thumbnail image URL.
      - **medium** (string) - Medium image URL.
      - **poster** (string) - Poster image URL.

#### Response Example
```json
[
  {
    "list_id": 1,
    "episode_seen": 3,
    "rating": 0,
    "priority": 0,
    "times_rewatched": 0,
    "rewatch_value": 0,
    "date_start": "0000-00-00",
    "date_finish": "0000-00-00",
    "note": "testing2",
    "tags": "",
    "updated_at": "2019-04-04T06:29:03Z",
    "title": {
      "id": 25172,
      "title": "My Mister",
      "original_title": "나의 아저씨",
      "year": 2018,
      "episodes": 16,
      "rating": 9.2,
      "released": true,
      "ended": true,
      "type": "Drama",
      "country": "South Korea",
      "language": "Korean",
      "images": {
        "thumb": "...",
        "medium": "...",
        "poster": "..."
      }
    }
  }
]
```
```

--------------------------------

### Get Last Activities

Source: https://mydramalist.github.io/MDL-API

Retrieves the timestamps of the last activities for different watchlist types.

```APIDOC
## Get Last Activities

### Description
Retrieves the timestamps of the last activities for different watchlist types.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/sync/last_activities`

### Response
#### Success Response (200)
- **all** (datetime) - Timestamp of the last activity across all types.
- **watching_at** (datetime) - Timestamp of the last activity for items marked as 'watching'.
- **completed_at** (datetime) - Timestamp of the last activity for items marked as 'completed'.
- **onhold_at** (datetime) - Timestamp of the last activity for items marked as 'on hold'.
- **plan_to_watch_at** (datetime) - Timestamp of the last activity for items marked as 'plan to watch'.
- **dropped_at** (datetime) - Timestamp of the last activity for items marked as 'dropped'.
- **not_interested_at** (datetime) - Timestamp of the last activity for items marked as 'not interested'.
- **rated_at** (datetime) - Timestamp of the last activity for items that were rated.

#### Response Example
```json
{
  "all": "2019-04-03T22:53:52Z",
  "watching_at": "2019-04-03T22:53:52Z",
  "completed_at": "2019-04-03T22:53:52Z",
  "onhold_at": "0001-01-01T00:00:00Z",
  "plan_to_watch_at": "0001-01-01T00:00:00Z",
  "dropped_at": "0001-01-01T00:00:00Z",
  "not_interested_at": "0001-01-01T00:00:00Z",
  "rated_at": "2019-04-03T22:53:52Z"
}
```
```

--------------------------------

### Get last activities via cURL

Source: https://mydramalist.github.io/MDL-API

Retrieves the timestamps of the user's last activities.

```bash
curl "https://api.mydramalist.com/v1/sync/last_activities" \
  -H "Content-Type: application/json" \
  -H "mdl-api-key: [client_id]"
```

```json
{
  "all": "2019-04-03T22:53:52Z",
  "watching_at": "2019-04-03T22:53:52Z",
  "completed_at": "2019-04-03T22:53:52Z",
  "onhold_at": "0001-01-01T00:00:00Z",
  "plan_to_watch_at": "0001-01-01T00:00:00Z",
  "dropped_at": "0001-01-01T00:00:00Z",
  "not_interested_at": "0001-01-01T00:00:00Z",
  "rated_at": "2019-04-03T22:53:52Z"
}
```

--------------------------------

### GET /v1/titles/[id]/reviews

Source: https://mydramalist.github.io/MDL-API

Retrieves all reviews for a specific TV show or movie, identified by its ID.

```APIDOC
## Get all reviews

### Description
Retrieves all reviews for a TV show or movie.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/titles/[id]/reviews`

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the title.

#### Headers
- **Content-Type**: application/json
- **mdl-api-key**: [client_id] - Your API key.

### Response
#### Success Response (200)
Returns an array of review objects. Each object contains details about the review, author, and the title it pertains to.

#### Response Example
```json
[
  {
    "id": 47125,
    "ratings": {
      "story": 7,
      "acting": 8.5,
      "music": 8.5,
      "rewatch": 8.5,
      "overall": 8.5
    },
    "headline": "",
    "review": "Pellentesque dapibus hendrerit tortor. Maecenas ullamcorper...",
    "version": 4,
    "upvotes": 0,
    "total_votes": 0,
    "completed": true,
    "dropped": false,
    "spoiler": false,
    "lang_iso": "en-US",
    "comments": 19,
    "voted": 0,
    "episodes": 1,
    "episodes_seen": 1,
    "author": {
      "username": "Dummy",
      "display_name": "Dummy",
      "avatar_url": "..."
    },
    "title": {
      "id": 24640,
      "slug": "/24640-test-content",
      "title": "Test Content",
      "type": "Movie",
      "year": 2018,
      "images": {
        "thumb": "...",
        "medium": "...",
        "poster": "..."
      }
    },
    "created_at": "2019-05-13T08:09:55Z"
  }
]
```
```

--------------------------------

### Get Title Credits

Source: https://mydramalist.github.io/MDL-API

Retrieve the cast and crew credits for a specific person by their ID. Requires an MDL API key.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/people/[ID]/credits \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

--------------------------------

### GET /v1/people/[ID]/credits

Source: https://mydramalist.github.io/MDL-API

Retrieves the TV show or movie credits for a specific person by their ID.

```APIDOC
## GET /v1/people/[ID]/credits

### Description
Get the TV show or movie credits for a person.

### Method
GET

### Endpoint
https://api.mydramalist.com/v1/people/[ID]/credits

### Parameters
#### Path Parameters
- **ID** (string) - Required - The unique identifier of the person.

### Response
#### Success Response (200)
- **cast** (array) - List of cast roles.
- **crew** (array) - List of crew roles.

#### Response Example
{
  "cast": [
    {
      "role": "Main Role",
      "also_known_as": "Seo Yoo Jin",
      "title": {
        "id": 242,
        "slug": "/242-cinderella-man",
        "title": "Cinderella Man",
        "original_title": "신데렐라 맨",
        "year": 2009,
        "episodes": 16,
        "rating": 6.7,
        "type": "Drama",
        "language": "Korean",
        "images": {
          "thumb": "...",
          "medium": "...",
          "poster": "..."
        }
      }
    }
  ],
  "crew": []
}
```

--------------------------------

### GET /v1/people/[ID]

Source: https://mydramalist.github.io/MDL-API

Retrieves detailed information about a specific person (actor, director, etc.) by their ID.

```APIDOC
## Get a person details

### Description
Retrieves the primary details for a person by their unique ID.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/people/[ID]`

### Parameters
#### Path Parameters
- **ID** (integer) - Required - The unique identifier of the person.

#### Headers
- **Content-Type**: application/json
- **mdl-api-key**: [client_id] - Your API key.

### Response
#### Success Response (200)
Returns a JSON object containing the person's details, including name, biography, birthday, nationality, and image URLs.

#### Response Example
```json
{
  "id": 972,
  "name": "Im Yoon Ah",
  "first_name": "Yoon Ah",
  "family_name": "Im",
  "original_name": "임윤아",
  "biography": "Im Yoon Ah, commonly stylized as Yoona, is a popular South Korean pop singer, dancer, actress, model and spokesmodel. She is a member of the Korean girl group Girls' Generation and is known as the center-girl, lead dancer and sub-vocalist of the group. Yoona made her debut as a singer along with Girls' Generation on August 5, 2007. She made her debut as an actress in the 2007 Korean drama, 9 Ends, 2 Outs. \nIn January 2014, Yoona and actor Lee Seung Gi were confirmed to be in a relationship since September 2013. On the 13 of August 2015, both stars confirmed they broke up after dating for a year and nine months due to busy schedules.",
  "permalink": "https://mydramalistcom/people/972-im-yoon-ah",
  "slug": "people/972-im-yoon-ah",
  "birthday": "1990-05-30",
  "dod": "0000-00-00",
  "nationality": "South Korean",
  "thumbnail": "",
  "images": {
    "thumb": "...",
    "medium": "...",
    "poster": "..."
  }
}
```
```

--------------------------------

### GET /v1/titles/[id]/related

Source: https://mydramalist.github.io/MDL-API

Retrieves a list of related titles for a given TV show or movie ID.

```APIDOC
## Get related titles

### Description
Retrieves a list of related titles for a TV show or movie.

### Method
GET

### Endpoint
`https://api.mydramalist.com/v1/titles/[id]/related`

### Parameters
#### Path Parameters
- **id** (integer) - Required - The unique identifier of the title.

#### Headers
- **Content-Type**: application/json
- **mdl-api-key**: [client_id] - Your API key.

### Response
#### Success Response (200)
Returns an array of related title objects, including their ID, title, year, rating, and image information.

#### Response Example
```json
[
  {
    "id": 50319,
    "title": "Unknown Number",
    "original_title": "时空来电",
    "year": 2019,
    "rating": 9.1,
    "permalink": "/50319-unknown-number",
    "type": "Drama",
    "language": "Chinese",
    "related_type": "Remake",
    "images": {
      "thumb": "...",
      "medium": "...",
      "poster": "..."
    }
  }
]
```
```

--------------------------------

### Authentication with API Key

Source: https://mydramalist.github.io/MDL-API

Use the mdl-api-key header to authenticate requests. Replace [client_id] with your registered API key.

```bash
curl "api_endpoint_here"
  -H "mdl-api-key: [client_id]"
```

--------------------------------

### Retrieve Title Details

Source: https://mydramalist.github.io/MDL-API

Fetches information for a specific TV show or movie by its ID.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/titles/[id] \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
{
  "id": 24640,
  "slug": "24640-test-content",
  "title": "Test Content",
  "original_title": "Test Content Native 2",
  "year": 2018,
  "rating": 0,
  "permalink": "https://mydramalist.com/24640-test-content",
  "synopsis": "Aenean ligula eget dolor. Vestibulum turpis sem...",
  "type": "Movie",
  "language": "Japanese",
  "images": {
    "thumb": "...",
    "medium": "...",
    "poster": "..."
  },
  "alt_titles": [
    "Test content"
  ],
  "country": "Japan",
  "episodes": 1,
  "watchers": 4,
  "released": "2018-01-02",
  "genres": [
    "action",
    "adventure",
    "business"
  ],
  "tags": [
    "Food",
    "manga",
    "time travel",
    "Adapted From A Novel",
    "instant attraction",
    "anime",
    "Mystery",
    "Nice Male Lead"
  ],
  "trailer": 0,
  "runtime": 30,
  "certification": "Not Yet Rated",
  "status": "",
  "updated_at": 1501468950
}
```

--------------------------------

### Retrieve Title Credits

Source: https://mydramalist.github.io/MDL-API

Fetches the cast and crew credits for a specific TV show or movie.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/titles/[id]/credits \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
{
  "cast": [
    {
      "id": 5043,
      "name": "Lee Jun Ho",
      "slug": "5043-lee-jun-ho",
      "images": {
        "thumb": "...",
        "poster": "..."
      },
      "character_name": "Seo Poong",
      "role": "Main Role"
    },
    {
      "id": 181,
      "name": "Jang Hyuk",
      "slug": "181-jang-hyuk",
      "images": {
        "thumb": "...",
        "poster": "..."
      },
      "character_name": "Doo Chil Seong",
      "role": "Main Role"
    }
]
```

--------------------------------

### Retrieve Title Ratings

Source: https://mydramalist.github.io/MDL-API

Fetches the ratings distribution for a specific TV show or movie.

```bash
curl -X GET \
  https://api.mydramalist.com/v1/titles/[id]/ratings \
  -H "Content-Type: application/json" \
  -H 'mdl-api-key: [client_id]'
```

```json
{
  "rating": 8,
  "votes": 4207,
  "distribution": {
    "9.5": 324,
    "4.0": 31,
    "6.5": 166,
    "7.0": 431,
    "7.5": 455,
    "4.5": 27,
    "10.0": 491,
    "1.5": 2,
    "2.0": 13,
    "2.5": 10,
    "3.0": 16,
    "8.0": 765,
    "8.5": 641,
    "9.0": 620,
    "3.5": 10,
    "5.0": 93,
    "5.5": 59,
    "6.0": 175,
    "1.0": 24
  }
}
```

--------------------------------

### Create Review

Source: https://mydramalist.github.io/MDL-API

Post a new review for a TV show or movie. The `parent_id` is required to link the review to a specific title. Requires an authorization token and an MDL API key.

```bash
curl -X POST \
  'https://api.mydramalist.com/v1/reviews' \
  -H "Content-Type: application/json" \
  -H 'authorization: Bearer [access_token]' \
  -H 'mdl-api-key: [client_id]' \
  --data '{ 
"completed": true,
"dropped": false,
"episodes_seen": 1,
"headline": null,
"parent_id": 24640,
"lang_iso": "en-US",
"ratings": {
  "story": 9, 
  "acting": 8.5, 
  "music": 9, 
  "rewatch": 8.5, 
  "overall": 9.5
},
"review": "Donec id justo. Suspendisse eanim turpis, dictum sed, iaculis a, condimentum nec, nisi. Fusce fermentum odio nec arcu. Nullam sagittis. Cras dapibus.\n\nEtiam vitae tortor. Suspendisse feugiat. Phasellus dolor. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Fusce a quam.\n\nDonec orci lectus, aliquam ut, faucibus non, euismod id, nulla. Nunc nulla. Vivamus elementum semper nisi. \n\nPellentesque egestas, neque sit amet convallis pulvinar, justo nulla eleifend augue, ac auctor orci leo non est. Quisque ut nisi.",
"spoiler": false
}'
```

--------------------------------

### POST /v1/reviews

Source: https://mydramalist.github.io/MDL-API

Creates a new review for a TV show or movie.

```APIDOC
## POST /v1/reviews

### Description
Post a review for a TV show or movie. The parent_id field is required.

### Method
POST

### Endpoint
https://api.mydramalist.com/v1/reviews

### Parameters
#### Request Body
- **completed** (boolean) - Required
- **dropped** (boolean) - Required
- **episodes_seen** (integer) - Required
- **headline** (string) - Optional
- **parent_id** (integer) - Required
- **lang_iso** (string) - Required
- **ratings** (object) - Required
- **review** (string) - Required
- **spoiler** (boolean) - Required

### Request Example
{
  "completed": true,
  "dropped": false,
  "episodes_seen": 1,
  "parent_id": 24640,
  "lang_iso": "en-US",
  "ratings": {
    "story": 9,
    "acting": 8.5,
    "music": 9,
    "rewatch": 8.5,
    "overall": 9.5
  },
  "review": "Review content here",
  "spoiler": false
}
```

--------------------------------

### Add to watchlist via cURL

Source: https://mydramalist.github.io/MDL-API

Adds items to the user's watchlist.

```bash
curl -X POST \
  'https://api.mydramalist.com/v1/sync/mylist' \
  -H "Content-Type: application/json" \
  -H 'authorization: Bearer [access_token]' \
  -H 'mdl-api-key: [client_id]' \
  --data '[
  {
    "list_id": 1,
    "episode_seen": 4,
    "rating": 0,
    "priority": 0,
    "times_rewatched": 0,
    "rewatch_value": 0,
    "date_start": "0000-00-00",
    "date_finish": "0000-00-00",
    "note": "testing2",
    "title": {
      "id": 25172,
      "title": "My Mister",
      "year": 2018,
      "type": "Drama",
      "country": "South Korea"
    }
  },
  {...}
]'
```

```json
{
  "success": {
    "titles": 1
  },
  "not_found": {
    "titles": [
      {
        "id": 191641111,
        "title": "Tokyo Ghoul"
      }
    ]
  }
}
```

--------------------------------

### Add to Watchlist

Source: https://mydramalist.github.io/MDL-API

Adds one or more items to the user's watchlist.

```APIDOC
## Add to Watchlist

### Description
Adds one or more items to the user's watchlist.

### Method
POST

### Endpoint
`https://api.mydramalist.com/v1/sync/mylist`

### Request Body
- **watchlist_items** (array) - Required - An array of watchlist objects to add.
  - **list_id** (integer) - Required - The ID of the item.
  - **episode_seen** (integer) - Optional - Number of episodes seen.
  - **rating** (float) - Optional - User's rating.
  - **priority** (integer) - Optional - Priority of the item.
  - **times_rewatched** (integer) - Optional - Number of times rewatched.
  - **rewatch_value** (integer) - Optional - Rewatch value.
  - **date_start** (date) - Optional - Start date of watching.
  - **date_finish** (date) - Optional - Finish date of watching.
  - **note** (string) - Optional - User's notes.
  - **title** (object) - Required - Details of the title.
    - **id** (integer) - Required - Title ID.
    - **title** (string) - Optional - Title name.
    - **year** (integer) - Optional - Release year.
    - **type** (string) - Optional - Type of the title.
    - **country** (string) - Optional - Country of origin.

### Request Example
```json
[
  {
    "list_id": 1,
    "episode_seen": 4,
    "rating": 0,
    "priority": 0,
    "times_rewatched": 0,
    "rewatch_value": 0,
    "date_start": "0000-00-00",
    "date_finish": "0000-00-00",
    "note": "testing2",
    "title": {
      "id": 25172,
      "title": "My Mister",
      "year": 2018,
      "type": "Drama",
      "country": "South Korea"
    }
  },
  {
    "list_id": 2,
    "title": {
      "id": 12345
    }
  }
]
```

### Response
#### Success Response (200)
- **success** (object) - Contains information about successfully added titles.
  - **titles** (integer) - Number of titles successfully added.
- **not_found** (object) - Contains information about titles that were not found.
  - **titles** (array) - A list of titles that were not found.
    - **id** (integer) - The ID of the not found title.
    - **title** (string) - The name of the not found title.

#### Response Example
```json
{
  "success": {
    "titles": 1
  },
  "not_found": {
    "titles": [
      {
        "id": 191641111,
        "title": "Tokyo Ghoul"
      }
    ]
  }
}
```
```

--------------------------------

### Update a review via cURL

Source: https://mydramalist.github.io/MDL-API

Updates an existing review. The authenticated user must be the original author of the review.

```bash
curl -X PATCH \
  'https://api.mydramalist.com/v1/reviews/[ID]' \
  -H "Content-Type: application/json" \
  -H 'authorization: Bearer [access_token]' \
  -H 'mdl-api-key: [client_id]' \
  --data '{
"completed": true,
"dropped": false,
"episodes_seen": 1,
"headline": null,
"id": 41568,
"lang_iso": "es",
"ratings": {
  "story": 9, 
  "acting": 8.5, 
  "music": 9, 
  "rewatch": 8.5, 
  "overall": 9.5
},
"review": "Donec id justo. Suspendisse eanim turpis, dictum sed, iaculis a, condimentum nec, nisi. Fusce fermentum odio nec arcu. Nullam sagittis. Cras dapibus.\n\nEtiam vitae tortor. Suspendisse feugiat. Phasellus dolor. Aenean leo ligula, porttitor eu, consequat vitae, eleifend ac, enim. Fusce a quam.\n\nDonec orci lectus, aliquam ut, faucibus non, euismod id, nulla. Nunc nulla. Vivamus elementum semper nisi. \n\nPellentesque egestas, neque sit amet convallis pulvinar, justo nulla eleifend augue, ac auctor orci leo non est. Quisque ut nisi.",
"spoiler": false
}'
```

--------------------------------

### Authentication Endpoints

Source: https://mydramalist.github.io/MDL-API

Endpoints for authorizing and obtaining access tokens for the MyDramaList API.

```APIDOC
## Authentication

### Authorize
`GET https://api.mydramalist.com/v1/oauth/authorize?response_type=code&client_id=[CLIENT_ID]&redirect_uri=[REDIRECT_URI]`

### Get Access Token
`POST https://api.mydramalist.com/v1/oauth/token?response_type=authorization_code&client_id=[CLIENT_ID]&client_secret=[CLIENT_SECRET]&redirect_uri=[REDIRECT_URI]&code=[AUTHORIZE_CODE]`

### API Key Authentication
MyDramaList expects an API key to be included in all API requests to the server in the following header:
`mdl-api-key: [client_id]`

### Bearer Token Authentication
The bearer authorization header is scoped to an authorized platform user or application.
`Authorization: Bearer [access_token]`
```

--------------------------------

### Remove from watchlist via cURL

Source: https://mydramalist.github.io/MDL-API

Removes items from the user's watchlist.

```bash
curl X DELETE \
  'http://api.mydramalist.com/sync/mylist' \
  -H 'authorization: Bearer [access_token]' \
  -H 'content-type: application/json' \
  -H 'mdl-api-key: [client_id]' \
  --data '[
      {
          "id": 12345
      },
      {
          "id": 25172
      }
    ]'
```

```json
{
  "deleted": {
    "titles": 1
  },
  "not_found": {
    "titles": [
      {
        "id": 12345
      }
    ]
  }
}
```

--------------------------------

### Search Titles API

Source: https://mydramalist.github.io/MDL-API

Endpoint for searching titles within the MyDramaList database.

```APIDOC
## Search Titles

### POST /v1/search/titles

#### Description
Searches for titles based on a query.

#### Query Parameters
- **q** (string) - Required - The search query.
```

--------------------------------

### API Error Codes

Source: https://mydramalist.github.io/MDL-API

A list of error codes that the MyDramaList API may return.

```APIDOC
## API Error Codes

### Description
The Kittn API uses the following error codes:

| Error Code | Meaning |
|---|---|
| 400 | Bad Request -- Your request is invalid. |
| 401 | Unauthorized -- Your API key is wrong. |
| 403 | Forbidden -- The kitten requested is hidden for administrators only. |
| 404 | Not Found -- The specified kitten could not be found. |
| 405 | Method Not Allowed -- You tried to access a kitten with an invalid method. |
| 406 | Not Acceptable -- You requested a format that isn't json. |
| 410 | Gone -- The kitten requested has been removed from our servers. |
| 418 | I'm a teapot. |
| 429 | Too Many Requests -- You're requesting too many kittens! Slow down! |
| 500 | Internal Server Error -- We had a problem with our server. Try again later. |
| 503 | Service Unavailable -- We're temporarily offline for maintenance. Please try again later. |
```
Tokens:
Raw