Skip to main content

​
Overview

The Studio resource represents animation production studios. Studios can be associated with multiple anime and have their own images and external resources.

​
List Studios

​
GET
endpoint
/api/studio
Retrieve a paginated list of studios.

​
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 produced by this studio
  • anime.animethemes - Themes for anime
  • anime.images - Images for anime
  • images - Studio images
  • resources - External resources (official website, social media)
​
filter[name]
string
Filter by studio name
​
fields[studio]
string
Comma-separated list of fields to return. Available fields:
  • studio_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 studio names

​
Response

​
studios
array
Array of studio objects
​
studio_id
integer
Unique identifier
​
name
string
Studio 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/studio?include=anime,images&page[size]=10"

​
Example Response

{
  "studios": [
    {
      "studio_id": 1,
      "name": "Sunrise",
      "slug": "sunrise",
      "created_at": "2024-01-15T12:00:00.000000Z",
      "updated_at": "2024-01-15T12:00:00.000000Z",
      "anime": [
        {
          "anime_id": 1,
          "name": "Cowboy Bebop",
          "slug": "cowboy_bebop",
          "year": 1998,
          "season": "Spring"
        },
        {
          "anime_id": 2,
          "name": "Mobile Suit Gundam",
          "slug": "mobile_suit_gundam",
          "year": 1979,
          "season": "Spring"
        }
      ],
      "images": [
        {
          "image_id": 10,
          "facet": "Cover",
          "link": "https://animethemes.moe/storage/images/sunrise_logo.jpg"
        }
      ]
    }
  ],
  "links": {
    "first": "https://api.animethemes.moe/api/studio?page[number]=1",
    "next": "https://api.animethemes.moe/api/studio?page[number]=2"
  },
  "meta": {
    "current_page": 1,
    "per_page": 10
  }
}

​
Show Studio

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

​
Path Parameters

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

​
Query Parameters

​
include
string
Same includes as list endpoint

​
Example Request

curl "https://api.animethemes.moe/api/studio/sunrise?include=anime.animethemes,images,resources"

​
Example Response

{
  "studio": {
    "studio_id": 1,
    "name": "Sunrise",
    "slug": "sunrise",
    "created_at": "2024-01-15T12:00:00.000000Z",
    "updated_at": "2024-01-15T12:00:00.000000Z",
    "anime": [
      {
        "anime_id": 1,
        "name": "Cowboy Bebop",
        "slug": "cowboy_bebop",
        "year": 1998,
        "season": "Spring",
        "animethemes": [
          {
            "theme_id": 1,
            "type": "OP",
            "sequence": 1,
            "slug": "OP1"
          },
          {
            "theme_id": 2,
            "type": "ED",
            "sequence": 1,
            "slug": "ED1"
          }
        ]
      }
    ],
    "images": [
      {
        "image_id": 10,
        "facet": "Cover",
        "link": "https://animethemes.moe/storage/images/sunrise_logo.jpg"
      }
    ],
    "resources": [
      {
        "resource_id": 50,
        "external_id": "sunrise",
        "site": "Official Site",
        "link": "https://www.sunrise-inc.co.jp/"
      }
    ]
  }
}

​
Create Studio

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

​
Request Body

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

​
Update Studio

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

​
Request Body

Same fields as create endpoint (all optional).

​
Delete Studio

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

​
Restore Studio

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

​
Force Delete Studio

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

Build docs developers (and LLMs) love

Get started for freeTalk to us