Skip to main content

​
Overview

The Series resource represents collections of related anime. A series groups multiple anime titles together, such as different seasons or related shows in a franchise.

​
List Series

​
GET
endpoint
/api/series
Retrieve a paginated list of series.

​
Query Parameters

​
page[size]
integer
Number of results per page (default: 15, max: 100)
​
page[number]
integer
Page number to retrieve
​
include
string
Comma-separated list of relationships to include. Available includes:
  • anime - Anime in this series
  • anime.animesynonyms - Anime synonyms/alternative titles
  • anime.images - Images for anime in the series
  • anime.animethemes - Themes for anime in the series
  • anime.studios - Studios for anime in the series
​
filter[name]
string
Filter by series name
​
fields[series]
string
Comma-separated list of fields to return. Available fields:
  • series_id
  • name
  • slug
​
sort
string
Sort by field. Prefix with - for descending order. Available: name, created_at, updated_at
​
q
string
Full-text search query across series names and anime

​
Response

​
series
array
Array of series objects
​
series_id
integer
Unique identifier
​
name
string
Series name
​
slug
string
URL-friendly identifier
​
created_at
string
ISO 8601 timestamp
​
updated_at
string
ISO 8601 timestamp

​
Example Request

curl "https://api.animethemes.moe/api/series?include=anime&page[size]=10"

​
Example Response

{
  "series": [
    {
      "series_id": 1,
      "name": "Monogatari",
      "slug": "monogatari",
      "created_at": "2024-01-15T12:00:00.000000Z",
      "updated_at": "2024-01-15T12:00:00.000000Z",
      "anime": [
        {
          "anime_id": 101,
          "name": "Bakemonogatari",
          "slug": "bakemonogatari",
          "year": 2009,
          "season": "Summer"
        },
        {
          "anime_id": 102,
          "name": "Nisemonogatari",
          "slug": "nisemonogatari",
          "year": 2012,
          "season": "Winter"
        },
        {
          "anime_id": 103,
          "name": "Nekomonogatari: Kuro",
          "slug": "nekomonogatari_kuro",
          "year": 2012,
          "season": "Winter"
        }
      ]
    }
  ],
  "links": {
    "first": "https://api.animethemes.moe/api/series?page[number]=1",
    "next": "https://api.animethemes.moe/api/series?page[number]=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 10
  }
}

​
Show Series

​
GET
endpoint
/api/series/:slug
Retrieve a single series by its slug.

​
Path Parameters

​
slug
string
required
The series slug (URL-friendly identifier)

​
Query Parameters

​
include
string
Same includes as list endpoint

​
Example Request

curl "https://api.animethemes.moe/api/series/monogatari?include=anime.animethemes,anime.images"

​
Example Response

{
  "series": {
    "series_id": 1,
    "name": "Monogatari",
    "slug": "monogatari",
    "created_at": "2024-01-15T12:00:00.000000Z",
    "updated_at": "2024-01-15T12:00:00.000000Z",
    "anime": [
      {
        "anime_id": 101,
        "name": "Bakemonogatari",
        "slug": "bakemonogatari",
        "year": 2009,
        "season": "Summer",
        "animethemes": [
          {
            "theme_id": 501,
            "type": "OP",
            "sequence": 1,
            "slug": "OP1"
          },
          {
            "theme_id": 502,
            "type": "OP",
            "sequence": 2,
            "slug": "OP2"
          }
        ],
        "images": [
          {
            "image_id": 201,
            "facet": "Cover",
            "link": "https://animethemes.moe/storage/images/bakemonogatari_cover.jpg"
          }
        ]
      }
    ]
  }
}

​
Create Series

​
POST
endpoint
/api/series
Create a new series. Requires authentication.

​
Request Body

​
name
string
required
Series name
​
slug
string
required
URL-friendly identifier (unique)

​
Update Series

​
PUT
endpoint
/api/series/:slug
Update an existing series. Requires authentication.

​
Request Body

Same fields as create endpoint (all optional).

​
Delete Series

​
DELETE
endpoint
/api/series/:slug
Soft delete a series. Requires authentication.

​
Restore Series

​
PATCH
endpoint
/restore/series/:slug
Restore a soft-deleted series. Requires authentication.

​
Force Delete Series

​
DELETE
endpoint
/forceDelete/series/:slug
Permanently delete a series. Requires authentication.

Build docs developers (and LLMs) love

Get started for freeTalk to us