# Studio Ghibli API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/ghibli-api/..."
```

## Pricing
- **Free** (Free) — 9,800 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 138,000 calls/Mo, 8 req/s
- **Pro** ($10/Mo) — 680,000 calls/Mo, 20 req/s
- **Mega** ($31/Mo) — 2,780,000 calls/Mo, 50 req/s

## Endpoints

### Studio Ghibli

#### `GET /v1/film` — A film by title or id, or the filmography

**Parameters:**
- `title` (query, optional, string) — Title search, e.g. totoro Example: `totoro`
- `id` (query, optional, string) — Film UUID for a single film

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ghibli-api/v1/film?title=totoro"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/list` — Locations, species or vehicles

**Parameters:**
- `type` (query, required, string) — locations | species | vehicles Example: `vehicles`
- `id` (query, optional, string) — UUID for a single item
- `limit` (query, optional, string) — Max results (1-250, default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ghibli-api/v1/list?type=vehicles&limit=50"
```

**Response:**
```json
{
    "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
}
```

#### `GET /v1/people` — A person by id, or search by name

**Parameters:**
- `name` (query, optional, string) — Name search, e.g. haku Example: `haku`
- `id` (query, optional, string) — Person UUID
- `limit` (query, optional, string) — Max results (1-250, default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ghibli-api/v1/people?name=haku&limit=50"
```

**Response:**
```json
{
    "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
}
```

### Meta

#### `GET /v1/meta` — Resource types & usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/ghibli-api/v1/meta"
```

**Response:**
```json
{
    "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
}
```


---
Marketplace page: https://www.oanor.com/api/ghibli-api
OpenAPI spec: https://www.oanor.com/api/ghibli-api/openapi.json