Studio Ghibli API
Free Studio Ghibli API with no key: films with descriptions, directors, scores and release dates, plus characters, locations and vehicles. Tested example.
Endpoint tested and returned HTTP 200 on 2026-08-19
What is the Studio Ghibli API?
The Studio Ghibli API is a free, key-free REST API providing data on Studio Ghibli films — titles, descriptions, directors, producers, release dates and Rotten Tomatoes scores — plus characters, locations, species and vehicles.
This API covers a small, complete and stable dataset: roughly two dozen films with substantial descriptive text for each. That combination — small enough to hold in your head, rich enough to render attractively — makes it a good fit for teaching and portfolio work.
Because the dataset barely changes, it is an ideal candidate for aggressive caching or even a build-time fetch. There is no reason to call it at runtime on every page view.
Quick facts
- Base URL
https://ghibliapi.vercel.app- Authentication
- No key required.
- Rate limit
- No published limit.
- Pricing
- Free and open source.
- CORS
- Enabled — callable directly from browser JavaScript
- Official docs
- Read the docs
How to use the Studio Ghibli API
Every request below was executed against the live API on 2026-08-19, and the response shown is the real body it returned — not an illustration.
1. List all Studio Ghibli films
GET https://ghibliapi.vercel.app/films
curl 'https://ghibliapi.vercel.app/films'const res = await fetch("https://ghibliapi.vercel.app/films");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);import requests
res = requests.get("https://ghibliapi.vercel.app/films", timeout=20)
res.raise_for_status()
print(res.json())[
{
"id": "2baf70d1-42bb-4437-b551-e5fed5a87abe",
"title": "Castle in the Sky",
"original_title": "天空の城ラピュタ",
"original_title_romanised": "Tenkū no shiro Rapyuta",
"image": "https://image.tmdb.org/t/p/w600_and_h900_bestv2/npOnzAbLh6VOIu3naU5QaEcTepo.jpg",
"movie_banner": "https://image.tmdb.org/t/p/w533_and_h300_bestv2/3cyjYtLWCBE1uvWINHFsFnE8LUK.jpg",
"description": "The orphan Sheeta inherited a mysterious crystal that links her to the mythical sky-kingdom of Laputa. With the help of resourceful Pazu and a rollicking band of sky pirates, she makes her way to the ruins of the once-great civilization. Sheeta and Pazu must outwit the evil Muska, who plans to use Laputa's science to make himself ruler of the world.",
"director": "Hayao Miyazaki",
"producer": "Isao Takahata",
"release_date": "1986",
"running_time": "124",
"rt_score": "95",
"people": [
"https://ghibliapi.vercel.app/people/598f7048-74ff-41e0-92ef-87dc1ad980a9",
"https://ghibliapi.vercel.app/people/fe93adf2-2f3a-4ec4-9f68-5422f1b87c01",
"https://ghibliapi.vercel.app/people/3bc0b41e-3569-4d20-ae73-2da329bf0786",
"https://ghibliapi.vercel.app/people/40c005ce-3725-4f15-8409-3e1b1b14b583",
"https://ghibliapi.vercel.app/people/5c83c12a-62d5-4e92-8672-33ac76ae1fa0",
"https://ghibliapi.vercel.app/people/e08880d0-6938-44f3-b179-81947e7873fc",
"https://ghibliapi.vercel.app/people/2a1dad70-802a-459d-8cc2-4ebd8821248b"
],
"species": [
"https://ghibliapi.vercel.app/species/af3910a6-429f-4c74-9ad5-dfe1c4aa04f2"
],Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
<resource> | path | Required | films, people, locations, species or vehicles. films |
<id> | path | Optional | UUID of a specific resource. 2baf70d1-42bb-4437-b551-e5fed5a87abe |
limit | integer | Optional | Maximum results. Defaults to 50. 10 |
Response fields
idstring- Resource UUID.
title / original_titlestring- English and original Japanese titles.
descriptionstring- Full plot synopsis — several sentences.
director / producerstring- Key creative credits.
release_datestring- Year of release.
rt_scorestring- Rotten Tomatoes score as a string.
What you can build with the Studio Ghibli API
- Build a film catalogue with rich descriptions and metadata
- Create a portfolio project with a small, high-quality dataset
- Practise build-time data fetching and static generation
- Teach REST basics without pagination complexity
Common errors and how to fix them
404
Unknown UUID.
Fix: Fetch the list endpoint first and use ids from it — they are UUIDs, not sequential integers.
Slow first response
Hosted on serverless infrastructure that can cold start.
Fix: Cache or fetch at build time; the data effectively never changes.
Studio Ghibli API — frequently asked questions
Is the Studio Ghibli API free?
Yes, completely free and open source with no API key required.
How many films does it include?
Around two dozen, covering the studio's major releases, each with a full synopsis, director, producer, release year and Rotten Tomatoes score.
Should I call this API at runtime?
Usually not. The dataset is small and effectively static, so fetching it at build time or caching indefinitely is a better fit than calling it per page view.
Does it include images?
The core film records focus on text metadata. Image availability has varied across versions of the API, so check the current response rather than assuming artwork is present.
Tools that pair with this API
JSON Formatter
Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.
Word Counter
Count words, characters, sentences, paragraphs and estimated reading time instantly. Free online word counter for essays, blogs and social media.
Studio Ghibli API is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-19; always check the official documentation before relying on this API in production, as terms and limits can change.