Skip to content
GET /v1/film

A film by title or id, or the filmography

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/ghibli-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/ghibli-api/v1/film" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/ghibli-api/v1/film", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/ghibli-api/v1/film");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/ghibli-api/v1/film",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "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
}