API Reference

Welcome to the official Morbotron Shows API documentation. This RESTful API allows you to access a vast database of anime shows, episodes, brands, and genres.

Base URL

https://api-service.morbotron.xyz/api/v1

Authentication

All API requests require a valid API key. You must include this key in the x-api-key header of your HTTP request.

cURL Example

curl -X GET "https://api-service.morbotron.xyz/api/v1/shows" \
  -H "x-api-key: sk_live_YOUR_API_KEY_HERE"

Pagination & Structure

Endpoints that return lists (like /shows or /search) always wrap the results in a data array and provide a pagination object.

Standard List Response

{
  "data": [
    // Array of objects...
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total_items": 154,
    "total_pages": 8,
    "has_next": true,
    "has_prev": false
  }
}

GET

/shows

Retrieves a paginated list of all available shows. You can filter and sort the results using query parameters.

Query Parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Items per page (max: 100, default: 20)
search	string	Search by show title
genre	string	Filter by exact genre name
brand	string	Filter by exact brand name
sort	enum	`latest`, `oldest`, `random`, title_asc, `title_desc`, `episodes_desc`

Response Example (200 OK)

{
  "data": [
    {
      "id": 1,
      "parent": "Ichigo Aika Collection",
      "parent_id": "GnjGxcSekz",
      "episode_count": 3,
      "alternate_titles": "Ichigo Aika Series",
      "synopsis": "A story about complicated relationships...",
      "createdAt": "2026-04-13T12:00:00.000Z",
      "Brand": { "id": 1, "name": "Pink Pineapple" },
      "Genres": [
        { "id": 1, "name": "Romance" },
        { "id": 2, "name": "Drama" }
      ]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total_items": 1,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

GET

/shows/{parent_id}

Retrieves detailed information for a specific show by its unique parent_id.

Response Example (200 OK)

{
  "id": 1,
  "parent": "Ichigo Aika Collection",
  "parent_id": "GnjGxcSekz",
  "episode_count": 3,
  "alternate_titles": "Ichigo Aika Series",
  "synopsis": "A story about complicated relationships...",
  "createdAt": "2026-04-13T12:00:00.000Z",
  "updatedAt": "2026-04-13T12:00:00.000Z",
  "brand_id": 1,
  "Brand": {
    "id": 1,
    "name": "Pink Pineapple"
  },
  "Genres": [
    {
      "id": 1,
      "name": "Romance",
      "ShowGenres": { "createdAt": "...", "updatedAt": "..." }
    }
  ]
}

GET

/shows/{parent_id}/episodes

Retrieves a paginated list of episodes belonging to a specific show.

Query Parameters

Parameter	Type	Description
page	integer	Page number
limit	integer	Items per page
sort	enum	`latest`, `oldest`, `random`, `episode_asc`, `episode_desc`, `views_desc`, `likes_desc`

Response Example (200 OK)

{
  "data": [
    {
      "id": 1,
      "video_id": "GnjGxcSekz_1",
      "filecode": "PLm982Ksa",
      "title": "Ichigo Aika Episode 1",
      "duration": "07:20",
      "synopsis": "The story begins...",
      "views": 6123450,
      "likes": 302145,
      "show_id": 1,
      "tags": [
        { "id": 3, "name": "Fantasy" }
      ]
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total_items": 1, "total_pages": 1, "has_next": false, "has_prev": false }
}

GET

/shows/{parent_id}/full

Retrieves detailed information for a specific show along with all of its episodes in a single response.

Response Example (200 OK)

{
  "id": 1,
  "parent": "Ichigo Aika Collection",
  "parent_id": "GnjGxcSekz",
  "episode_count": 3,
  "synopsis": "A story about complicated relationships...",
  "Brand": { "id": 1, "name": "Pink Pineapple" },
  "Genres": [ { "id": 1, "name": "Romance" } ],
  "Episodes": [
    {
      "id": 1,
      "video_id": "GnjGxcSekz_1",
      "title": "Ichigo Aika Episode 1",
      "duration": "07:20",
      "views": 6123450
    }
  ]
}

GET

/episodes

Retrieves a paginated list of all available episodes globally.

Query Parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Items per page (max: 100, default: 20)
sort	enum	`latest`, `oldest`, `random`

Response Example (200 OK)

{
  "data": [
    {
      "id": 100,
      "video_id": "XyZ123_1",
      "title": "Global Episode Title",
      "duration": "24:00",
      "Show": {
        "parent": "Show Name"
      }
    }
  ],
  "pagination": { "page": 1, "limit": 20, "total_items": 500, "total_pages": 25, "has_next": true, "has_prev": false }
}

GET

/episodes/{video_id}

Retrieves detailed information for a specific episode by its unique video_id.

Response Example (200 OK)

{
  "id": 1,
  "video_id": "GnjGxcSekz_1",
  "filecode": "PLm982Ksa",
  "title": "Ichigo Aika Episode 1",
  "duration": "07:20",
  "synopsis": "The story begins...",
  "views": 6123450,
  "likes": 302145,
  "show_id": 1,
  "tags": [
    { "id": 3, "name": "Fantasy" }
  ],
  "Show": {
    "id": 1,
    "parent": "Ichigo Aika Collection",
    "parent_id": "GnjGxcSekz"
  }
}

GET

/search

Global search endpoint to find shows or episodes by keyword.

Query Parameters

Parameter	Type	Description
q	string	Search query string
type	enum	`show` (default) or `episode`
page	integer	Page number

Response Example (200 OK)

{
  "data": [
    // Array of Shows or Episodes depending on 'type' parameter
  ],
  "pagination": { ... }
}