{"openapi":"3.1.0","info":{"title":"Studio Ghibli API","version":"1.0.0","description":"The films of Studio Ghibli as an API — all 22 feature films plus the people, locations, species and vehicles that fill their worlds. Look up a film by title or id (e.g. My Neighbor Totoro → directed by Hayao Miyazaki, 1988, 86 minutes, Rotten Tomatoes 93) or list the full filmography with director, producer, release date, running time, scores and artwork; search the characters by name (e.g. Haku) for gender, age and the films they appear in; and browse the locations, species and vehicles of the Ghibli universe. Backed by the open Studio Ghibli API. Ideal for film and anime apps, fan sites, trivia and quiz games, Discord bots and any Studio Ghibli project.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ghibli-api","description":"oanor gateway"}],"tags":[{"name":"Studio Ghibli"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/film":{"get":{"operationId":"get_v1_film","tags":["Studio Ghibli"],"summary":"A film by title or id, or the filmography","description":"","parameters":[{"name":"title","in":"query","required":false,"description":"Title search, e.g. totoro","schema":{"type":"string"},"example":"totoro"},{"name":"id","in":"query","required":false,"description":"Film UUID for a single film","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"films":[{"id":"58611129-2dbc-4a81-a72f-77ddfc1b1b49","image":"https://image.tmdb.org/t/p/w600_and_h900_bestv2/rtGDOeG9LzoerkDGZF9dnVeLppL.jpg","title":"My Neighbor Totoro","director":"Hayao Miyazaki","producer":"Hayao Miyazaki","rt_score":"93","description":"Two sisters move to the country with their father in order to be closer to their hospitalized mother, and discover the surrounding trees are inhabited by Totoros, magical spirits of the forest. When the youngest runs away from home, the older sister seeks help from the spirits to find her.","movie_banner":"https://image.tmdb.org/t/p/original/etqr6fOOCXQOgwrQXaKwenTSuzx.jpg","people_count":10,"release_date":"1988","running_time":"86 min","species_count":3,"vehicle_count":1,"location_count":1,"original_title":"となりのトトロ","original_title_romanised":"Tonari no Totoro"}],"total":1},"meta":{"timestamp":"2026-06-01T00:04:30.607Z","request_id":"3f7f31dc-b0b1-4da9-b62d-55b352a42fa1"},"status":"ok","message":"Film retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Studio Ghibli"],"summary":"Locations, species or vehicles","description":"","parameters":[{"name":"type","in":"query","required":true,"description":"locations | species | vehicles","schema":{"type":"string"},"example":"vehicles"},{"name":"id","in":"query","required":false,"description":"UUID for a single item","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-250, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"vehicles","count":3,"results":[{"id":"4e09b023-f650-4747-9ab9-eacf14540cfb","name":"Air Destroyer Goliath"},{"id":"d8f893b5-1dd9-41a1-9918-0099c1aa2de8","name":"Red Wing"},{"id":"923d70c9-8f15-4972-ad53-0128b261d628","name":"Sosuke's Boat"}]},"meta":{"timestamp":"2026-06-01T00:04:30.819Z","request_id":"0d308980-7dac-4d3b-b495-607ce1e7a560"},"status":"ok","message":"Resources listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/people":{"get":{"operationId":"get_v1_people","tags":["Studio Ghibli"],"summary":"A person by id, or search by name","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Name search, e.g. haku","schema":{"type":"string"},"example":"haku"},{"name":"id","in":"query","required":false,"description":"Person UUID","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-250, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"people":[{"id":"267649ac-fb1b-11eb-9a03-0242ac130003","age":"12","url":"https://ghibliapi.vercel.app/people/267649ac-fb1b-11eb-9a03-0242ac130003","name":"Haku","gender":"Male","eye_color":"Green","film_count":1,"hair_color":"Green"}]},"meta":{"timestamp":"2026-06-01T00:04:31.045Z","request_id":"67a07bce-ba68-46ea-9689-afeb505a18ad"},"status":"ok","message":"People retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Resource types & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The films of Studio Ghibli. /v1/film = a film by id (UUID), a title search (title=totoro), or all 22 films with director, release date, running time and Rotten Tomatoes score; /v1/people = a person by id or name search; /v1/list = locations, species or vehicles (type=, optional id= for detail). Ids are UUIDs.","types":["films","people","locations","species","vehicles"],"source":"Studio Ghibli API (ghibliapi.vercel.app)","endpoints":["/v1/film","/v1/people","/v1/list","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:31.117Z","request_id":"00f8e4fe-5c55-437b-90d3-db728af182da"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":9800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":300,"monthly_call_quota":138000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1020,"monthly_call_quota":680000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3130,"monthly_call_quota":2780000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ghibli-api"}