# IMDb — Zapi reference

> Database film, serial TV & selebriti terbesar di dunia — rating, info lengkap, cast, ulasan, chart, dan box office.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/movie/imdb
- Endpoint catalog: https://zpi.web.id/category/movie
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## IMDb

**Category:** movie · **Slug:** `imdb`
**Detail page:** https://zpi.web.id/api/movie/imdb

Database film, serial TV & selebriti terbesar di dunia — rating, info lengkap, cast, ulasan, chart, dan box office.

**Tags:** movie, tv, rating, celebrity, reviews

### Advanced Search

IMDb Advanced Search — cari title dengan filter (genre, tipe, tahun, rating).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/advanced-search`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | no | Kata kunci judul (opsional) |
| `genres` | string | query | no | Genre dipisah koma. Cth: Action, Comedy, Drama, Horror, Sci-Fi, Thriller, Romance, Animation |
| `type` | enum(movie|tv|tv_mini|tv_movie|short|video_game) | query | no | Filter tipe title (opsional) |
| `year_from` | number | query | no | Tahun rilis minimum (opsional) |
| `year_to` | number | query | no | Tahun rilis maksimum (opsional) |
| `rating_min` | number | query | no | Rating IMDb minimum 1-10 (opsional) |
| `sort` | enum(popularity|rating|newest|oldest) | query | no | Urutan hasil. Default popularity |
| `page` | number | query | no | Halaman (1,2,3…). Default 1, max 20 |
| `count` | number | query | no | Jumlah hasil per halaman. Default 25, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/advanced-search?q=batman&genres=Action%2CSci-Fi&type=movie&year_from=2000&year_to=2025&rating_min=7&sort=rating&page=1&count=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/advanced-search?q=batman&genres=Action%2CSci-Fi&type=movie&year_from=2000&year_to=2025&rating_min=7&sort=rating&page=1&count=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/advanced-search?q=batman&genres=Action%2CSci-Fi&type=movie&year_from=2000&year_to=2025&rating_min=7&sort=rating&page=1&count=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "count": 3,
  "total": 3,
  "filters": {
    "q": "batman",
    "sort": "rating",
    "type": "movie",
    "genres": "Action,Sci-Fi",
    "yearTo": 2025,
    "yearFrom": 2000,
    "ratingMin": 7
  },
  "hasMore": false,
  "results": [
    {
      "id": "tt4116284",
      "plot": "A cooler-than-ever Bruce Wayne must deal with the usual suspects as they plan to rule Gotham City, while discovering that he has accidentally adopted a teenage orphan who wishes to become his sidekick.",
      "type": "Movie",
      "year": 2017,
      "image": "https://m.media-amazon.com/images/M/MV5BMTcyNTEyOTY0M15BMl5BanBnXkFtZTgwOTAyNzU3MDI@._V1_QL75_UX200_.jpg",
      "title": "The Lego Batman Movie",
      "rating": 7.3,
      "voteCount": 193968,
      "runtimeMinutes": 104
    },
    {
      "id": "tt14324650",
      "plot": "Held hostage by the powerful Falcone crime family, Gotham City is rife with crime and corruption. Adding to the chaos is the mysterious Holiday killer, who has been targeting the underworld and leaving a trail of terror - and body bags.",
      "type": "Movie",
      "year": 2021,
      "image": "https://m.media-amazon.com/images/M/MV5BNzQ2NTY5YmUtMjQ2Yi00NzhhLWI4OGItNTIxNTVkZGE0ZGIwXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Batman: The Long Halloween, Part One",
      "rating": 7.3,
      "voteCount": 22848,
      "runtimeMinutes": 85
    },
    {
      "id": "tt14402926",
      "plot": "The killer known as Holiday continues to stalk the Falcone crime family while a new class of costumed criminal rises in Gotham City. Batman suspects that a former ally might be the serial killer.",
      "type": "Movie",
      "year": 2021,
      "image": "https://m.media-amazon.com/images/M/MV5BYWViZDQ4NGYtYjEwMi00YjFhLTg4NjQtNDlmNjY3YTJlZjIyXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Batman: The Long Halloween, Part Two",
      "rating": 7.2,
      "voteCount": 19428,
      "runtimeMinutes": 87
    }
  ],
  "nextPage": null
}
```

---

### Born Today

IMDb Born Today — daftar selebriti yang lahir pada tanggal tertentu.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/born-today`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `month` | number | query | no | Bulan 1-12. Default bulan hari ini |
| `day` | number | query | no | Tanggal 1-31. Default tanggal hari ini |
| `limit` | number | query | no | Jumlah orang. Default 20, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/born-today?month=1&day=1&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/born-today?month=1&day=1&limit=20", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/born-today?month=1&day=1&limit=20",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "date": "01-01",
  "count": 20,
  "people": [
    {
      "id": "nm3886028",
      "name": "Angourie Rice",
      "image": "https://m.media-amazon.com/images/M/MV5BMzMxNGM1YTItMGFiNi00NzdiLTg2NDctOTIzMzY2MDQ3ZDRkXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "The Nice Guys",
      "birthYear": 2001,
      "professions": [
        "Actress",
        "Producer",
        "Soundtrack"
      ]
    },
    {
      "id": "nm0001449",
      "name": "Frank Langella",
      "image": "https://m.media-amazon.com/images/M/MV5BMTI5MDc0NTI3Nl5BMl5BanBnXkFtZTcwMTgzNjQzMg@@._V1_QL75_UX300_.jpg",
      "knownFor": "Frost/Nixon",
      "birthYear": 1938,
      "professions": [
        "Actor",
        "Producer",
        "Soundtrack"
      ]
    },
    {
      "id": "nm0004820",
      "name": "Morris Chestnut",
      "image": "https://m.media-amazon.com/images/M/MV5BNDYzNDQzMTkwMl5BMl5BanBnXkFtZTgwOTYwNDQyMDI@._V1_QL75_UX300_.jpg",
      "knownFor": "Kick-Ass 2",
      "birthYear": 1969,
      "professions": [
        "Actor",
        "Producer",
        "Director"
      ]
    },
    {
      "id": "nm0266995",
      "name": "Stephanie Faracy",
      "image": "https://m.media-amazon.com/images/M/MV5BYjVlODY4MjUtNWFmOC00MTUzLThhMzgtNDViY2JjNjZmYzA4XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Nobody Wants This",
      "birthYear": 1952,
      "professions": [
        "Actress"
      ]
    },
    {
      "id": "nm0354937",
      "name": "Jennifer Hale",
      "image": "https://m.media-amazon.com/images/M/MV5BMTM4NzAxY2EtMmU0MS00OTg2LTk3OWEtMGNhOTFlYjJjNmFlXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Ratchet & Clank: Rift Apart",
      "professions": [
        "Actress",
        "Soundtrack",
        "Music Artist"
      ]
    },
    {
      "id": "nm2496312",
      "name": "Amara Karan",
      "image": "https://m.media-amazon.com/images/M/MV5BNjkzMzcwNzY5M15BMl5BanBnXkFtZTgwMDA0MDcwMTI@._V1_QL75_UX300_.jpg",
      "knownFor": "The Darjeeling Limited",
      "birthYear": 1984,
      "professions": [
        "Actress"
      ]
    },
    {
      "id": "nm2959880",
      "name": "Colin Morgan",
      "image": "https://m.media-amazon.com/images/M/MV5BMTk3Nzg2MjY0MV5BMl5BanBnXkFtZTgwNzM3NTc2NTE@._V1_QL75_UX300_.jpg",
      "knownFor": "Belfast",
      "birthYear": 1986,
      "professions": [
        "Actor"
      ]
    },
    {
      "id": "nm0000763",
      "name": "Dana Andrews",
      "image": "https://m.media-amazon.com/images/M/MV5BMWZmMjAwMjMtYmNkYS00YzQ2LWEwNjItODEyNDBmNzUzMDc1XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Laura",
      "birthYear": 1909,
      "professions": [
        "Actor",
        "Soundtrack"
      ]
    },
    {
      "id": "nm2934977",
      "name": "Jessica Gunning",
      "image": "https://m.media-amazon.com/images/M/MV5BNWQ2Mzk4NjAtMzRkOC00NTQzLWI1Y2EtM2MzMGRmZTgwYzM2XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Pride",
      "birthYear": 1986,
      "professions": [
        "Actress",
        "Writer"
      ]
    },
    {
      "id": "nm0806527",
      "name": "Sharon Small",
      "image": "https://m.media-amazon.com/images/M/MV5BNDI1MDI4ODgzNF5BMl5BanBnXkFtZTcwMjM2MjUzMg@@._V1_QL75_UX300_.jpg",
      "knownFor": "About a Boy",
      "birthYear": 1967,
      "professions": [
        "Actress"
      ]
    },
    {
      "id": "nm0679410",
      "name": "Dedee Pfeiffer",
      "image": "https://m.media-amazon.com/images/M/MV5BNGIwMDNiMjgtYTBjZi00OTVkLWI1YTMtM2YzMDdmYWJiNzRmXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Falling Down",
      "birthYear": 1964,
      "professions": [
        "Actress",
        "Producer",
        "Soundtrack"
      ]
    },
    {
      "id": "nm0001750",
      "name": "Madolyn Smith Osborne",
      "image": "https://m.media-amazon.com/images/M/MV5BNzQyNjA1MjYwMF5BMl5BanBnXkFtZTgwOTE5NTc3MjE@._V1_QL75_UX300_.jpg",
      "knownFor": "2010: The Year We Make Contact",
      "birthYear": 1957,
      "professions": [
        "Actress"
      ]
    },
    {
      "id": "nm0129379",
      "name": "Clare Calbraith",
      "image": "https://m.media-amazon.com/images/M/MV5BMWIzZGM5ZWItOTMxYi00NmNkLWI0OTQtYTg4ZTM1YTIyNjkzXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Grace",
      "birthYear": 1974,
      "professions": [
        "Actress"
      ]
    },
    {
      "id": "nm0509264",
      "name": "Anders Danielsen Lie",
      "image": "https://m.media-amazon.com/images/M/MV5BMjI0MDU2NTE3N15BMl5BanBnXkFtZTcwODI1Mjg3Nw@@._V1_QL75_UX300_.jpg",
      "knownFor": "Oslo, August 31st",
      "birthYear": 1979,
      "professions": [
        "Actor",
        "Soundtrack"
      ]
    },
    {
      "id": "nm0326988",
      "name": "Carlos Gómez",
      "image": "https://m.media-amazon.com/images/M/MV5BMjg3NDBjMTUtYjlhZC00ZTU4LTg3MTAtZDY2ZGMzNDA1N2FiXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "The Baker and the Beauty",
      "professions": [
        "Actor",
        "Producer"
      ]
    },
    {
      "id": "nm0231191",
      "name": "Fiona Dolman",
      "image": "https://m.media-amazon.com/images/M/MV5BMTY5NDcwMzIwN15BMl5BanBnXkFtZTgwMzA2OTk4ODE@._V1_QL75_UX300_.jpg",
      "knownFor": "Midsomer Murders",
      "birthYear": 1970,
      "professions": [
        "Actress",
        "Soundtrack"
      ]
    },
    {
      "id": "nm0873942",
      "name": "Verne Troyer",
      "image": "https://m.media-amazon.com/images/M/MV5BODg5ODk2NjgzMV5BMl5BanBnXkFtZTcwNjQ5NDcxNg@@._V1_QL75_UX300_.jpg",
      "knownFor": "The Love Guru",
      "birthYear": 1969,
      "professions": [
        "Actor",
        "Stunts",
        "Director"
      ]
    },
    {
      "id": "nm0945131",
      "name": "Kōji Yakusho",
      "image": "https://m.media-amazon.com/images/M/MV5BMTc4OTA5Njc4Nl5BMl5BanBnXkFtZTYwOTc0NDk0._V1_QL75_UX300_.jpg",
      "knownFor": "Perfect Days",
      "birthYear": 1956,
      "professions": [
        "Actor",
        "Director",
        "Writer"
      ]
    },
    {
      "id": "nm0800219",
      "name": "Josette Simon",
      "image": "https://m.media-amazon.com/images/M/MV5BZmI1Njg1NDItNjdkZC00MmJkLTgwZjYtNTM2ZDFmNzkwNjZkXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Wonder Woman",
      "birthYear": 1960,
      "professions": [
        "Actress"
      ]
    },
    {
      "id": "nm0916871",
      "name": "Derek Webster",
      "image": "https://m.media-amazon.com/images/M/MV5BMDk5NGRkYmItYjJhZS00NGZiLWI4YTktYmZlYTI3ZjcyYzMwXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "knownFor": "Godzilla",
      "professions": [
        "Actor"
      ]
    }
  ]
}
```

---

### Box Office

IMDb Box Office — chart pendapatan box office akhir pekan (weekend).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/box-office`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `limit` | number | query | no | Jumlah judul teratas. Default 10, max 20 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/box-office?limit=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/box-office?limit=10", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/box-office?limit=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 10,
  "items": [
    {
      "id": "tt26657236",
      "rank": 1,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BYzQyYjZmMjctMzIyZi00MDI0LWJhNGQtMzQ3MTFlNDgwNGM5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Backrooms",
      "rating": 7.1,
      "weekendGross": {
        "amount": 81402424,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 154198791,
        "currency": "USD"
      }
    },
    {
      "id": "tt37287335",
      "rank": 2,
      "year": 2025,
      "image": "https://m.media-amazon.com/images/M/MV5BYzc1NWUwMDgtNGZlMS00ZmYzLWIzMzktNmMxMmY1MTUzNWExXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Obsession",
      "rating": 8.1,
      "weekendGross": {
        "amount": 27395480,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 178778930,
        "currency": "USD"
      }
    },
    {
      "id": "tt30825738",
      "rank": 3,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BYjRkYzAzNjktZmRhMy00NjRiLWE0OTMtYmRmMTE5NDkzY2NlXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Star Wars: The Mandalorian and Grogu",
      "rating": 7,
      "weekendGross": {
        "amount": 24451576,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 257522349,
        "currency": "USD"
      }
    },
    {
      "id": "tt11378946",
      "rank": 4,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BNzllNmRlN2EtMDQyOC00ODJjLTg4OWQtZDNmNGU3YzlkNjc1XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Michael",
      "rating": 7.7,
      "weekendGross": {
        "amount": 11865524,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 859159812,
        "currency": "USD"
      }
    },
    {
      "id": "tt34459219",
      "rank": 5,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BZTQ3ZWQ4YTctMTI0OC00NmI5LWFlNjgtNjhhMDQxYjUxYTQyXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Breadwinner",
      "rating": 6.3,
      "weekendGross": {
        "amount": 7353073,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 11438057,
        "currency": "USD"
      }
    },
    {
      "id": "tt33612209",
      "rank": 6,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BZmM3ZDU3ODItZmY5Yi00OTQ2LWE5OTctZTA5NDBhMWJkOGY3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Devil Wears Prada 2",
      "rating": 6.6,
      "weekendGross": {
        "amount": 5872312,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 645140934,
        "currency": "USD"
      }
    },
    {
      "id": "tt32547691",
      "rank": 7,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BMjE2YjdkNDctMDg1MS00MjBjLWIyZjEtZWM1ZjczNTAzZGEyXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Pressure",
      "rating": 7.6,
      "weekendGross": {
        "amount": 5811480,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 8974250,
        "currency": "USD"
      }
    },
    {
      "id": "tt32565993",
      "rank": 8,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BNTFmZWI4YmMtNmQ0ZC00ZGQwLTk1OWEtZjAyZmIzOGY0MGFiXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Sheep Detectives",
      "rating": 7.6,
      "weekendGross": {
        "amount": 4694974,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 105516293,
        "currency": "USD"
      }
    },
    {
      "id": "tt33763941",
      "rank": 9,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BNDhmZmJlMDctNTA3MS00NTkwLThkZGQtMjM5MTdmMDg2YjBjXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Passenger",
      "rating": 5.6,
      "weekendGross": {
        "amount": 2722210,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 27648749,
        "currency": "USD"
      }
    },
    {
      "id": "tt17490712",
      "rank": 10,
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BNTg2YWNkN2EtMzc1Ny00ZTBhLWFmYTItMmMyNzhjNjhhNmVhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Mortal Kombat II",
      "rating": 6.6,
      "weekendGross": {
        "amount": 2001024,
        "currency": "USD"
      },
      "lifetimeGross": {
        "amount": 127243663,
        "currency": "USD"
      }
    }
  ],
  "weekendEnd": "2026-05-31",
  "weekendStart": "2026-05-29"
}
```

---

### Chart

IMDb Charts — daftar peringkat resmi IMDb (Top 250, Most Popular, dll).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/chart`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `chart` | enum(top_movies|top_english_movies|top_tv|popular_movies|popular_tv|lowest_movies) | query | no | Jenis chart. Default top_movies (IMDb Top 250 Movies) |
| `page` | number | query | no | Halaman (1,2,3…). Default 1, max 30 |
| `count` | number | query | no | Jumlah item per halaman. Default 25, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/chart?chart=top_movies&page=1&count=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/chart?chart=top_movies&page=1&count=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/chart?chart=top_movies&page=1&count=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "chart": "top_movies",
  "count": 25,
  "items": [
    {
      "id": "tt0111161",
      "rank": 1,
      "type": "Movie",
      "year": 1994,
      "image": "https://m.media-amazon.com/images/M/MV5BMDAyY2FhYjctNDc5OS00MDNlLThiMGUtY2UxYWVkNGY2ZjljXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Shawshank Redemption",
      "rating": 9.3,
      "voteCount": 3194285,
      "runtimeMinutes": 142
    },
    {
      "id": "tt0068646",
      "rank": 2,
      "type": "Movie",
      "year": 1972,
      "image": "https://m.media-amazon.com/images/M/MV5BNGEwYjgwOGQtYjg5ZS00Njc1LTk2ZGEtM2QwZWQ2NjdhZTE5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Godfather",
      "rating": 9.2,
      "voteCount": 2229395,
      "runtimeMinutes": 175
    },
    {
      "id": "tt0468569",
      "rank": 3,
      "type": "Movie",
      "year": 2008,
      "image": "https://m.media-amazon.com/images/M/MV5BMTMxNTMwODM0NF5BMl5BanBnXkFtZTcwODAyMTk2Mw@@._V1_QL75_UX200_.jpg",
      "title": "The Dark Knight",
      "rating": 9.1,
      "voteCount": 3175208,
      "runtimeMinutes": 152
    },
    {
      "id": "tt0071562",
      "rank": 4,
      "type": "Movie",
      "year": 1974,
      "image": "https://m.media-amazon.com/images/M/MV5BMDIxMzBlZDktZjMxNy00ZGI4LTgxNDEtYWRlNzRjMjJmOGQ1XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Godfather Part II",
      "rating": 9,
      "voteCount": 1496368,
      "runtimeMinutes": 202
    },
    {
      "id": "tt0050083",
      "rank": 5,
      "type": "Movie",
      "year": 1957,
      "image": "https://m.media-amazon.com/images/M/MV5BYjE4NzdmOTYtYjc5Yi00YzBiLWEzNDEtNTgxZGQ2MWVkN2NiXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "12 Angry Men",
      "rating": 9,
      "voteCount": 985440,
      "runtimeMinutes": 96
    },
    {
      "id": "tt0167260",
      "rank": 6,
      "type": "Movie",
      "year": 2003,
      "image": "https://m.media-amazon.com/images/M/MV5BMTZkMjBjNWMtZGI5OC00MGU0LTk4ZTItODg2NWM3NTVmNWQ4XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Lord of the Rings: The Return of the King",
      "rating": 9,
      "voteCount": 2167515,
      "runtimeMinutes": 201
    },
    {
      "id": "tt0108052",
      "rank": 7,
      "type": "Movie",
      "year": 1993,
      "image": "https://m.media-amazon.com/images/M/MV5BNjM1ZDQxYWUtMzQyZS00MTE1LWJmZGYtNGUyNTdlYjM3ZmVmXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Schindler's List",
      "rating": 9,
      "voteCount": 1586593,
      "runtimeMinutes": 195
    },
    {
      "id": "tt0120737",
      "rank": 8,
      "type": "Movie",
      "year": 2001,
      "image": "https://m.media-amazon.com/images/M/MV5BNzIxMDQ2YTctNDY4MC00ZTRhLTk4ODQtMTVlOWY4NTdiYmMwXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Lord of the Rings: The Fellowship of the Ring",
      "rating": 8.9,
      "voteCount": 2209642,
      "runtimeMinutes": 178
    },
    {
      "id": "tt0110912",
      "rank": 9,
      "type": "Movie",
      "year": 1994,
      "image": "https://m.media-amazon.com/images/M/MV5BYTViYTE3ZGQtNDBlMC00ZTAyLTkyODMtZGRiZDg0MjA2YThkXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Pulp Fiction",
      "rating": 8.8,
      "voteCount": 2438849,
      "runtimeMinutes": 154
    },
    {
      "id": "tt0060196",
      "rank": 10,
      "type": "Movie",
      "year": 1966,
      "image": "https://m.media-amazon.com/images/M/MV5BMWM5ZjQxM2YtNDlmYi00ZDNhLWI4MWUtN2VkYjBlMTY1ZTkwXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Good, the Bad and the Ugly",
      "rating": 8.8,
      "voteCount": 891327,
      "runtimeMinutes": 178
    },
    {
      "id": "tt0167261",
      "rank": 11,
      "type": "Movie",
      "year": 2002,
      "image": "https://m.media-amazon.com/images/M/MV5BMGQxMDdiOWUtYjc1Ni00YzM1LWE2NjMtZTg3Y2JkMjEzMTJjXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Lord of the Rings: The Two Towers",
      "rating": 8.8,
      "voteCount": 1960006,
      "runtimeMinutes": 179
    },
    {
      "id": "tt0109830",
      "rank": 12,
      "type": "Movie",
      "year": 1994,
      "image": "https://m.media-amazon.com/images/M/MV5BNDYwNzVjMTItZmU5YS00YjQ5LTljYjgtMjY2NDVmYWMyNWFmXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Forrest Gump",
      "rating": 8.8,
      "voteCount": 2500949,
      "runtimeMinutes": 142
    },
    {
      "id": "tt0137523",
      "rank": 13,
      "type": "Movie",
      "year": 1999,
      "image": "https://m.media-amazon.com/images/M/MV5BOTgyOGQ1NDItNGU3Ny00MjU3LTg2YWEtNmEyYjBiMjI1Y2M5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Fight Club",
      "rating": 8.8,
      "voteCount": 2614907,
      "runtimeMinutes": 139
    },
    {
      "id": "tt1375666",
      "rank": 14,
      "type": "Movie",
      "year": 2010,
      "image": "https://m.media-amazon.com/images/M/MV5BMjAxMzY3NjcxNF5BMl5BanBnXkFtZTcwNTI5OTM0Mw@@._V1_QL75_UX200_.jpg",
      "title": "Inception",
      "rating": 8.8,
      "voteCount": 2823283,
      "runtimeMinutes": 148
    },
    {
      "id": "tt0080684",
      "rank": 15,
      "type": "Movie",
      "year": 1980,
      "image": "https://m.media-amazon.com/images/M/MV5BMTkxNGFlNDktZmJkNC00MDdhLTg0MTEtZjZiYWI3MGE5NWIwXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Star Wars: Episode V - The Empire Strikes Back",
      "rating": 8.7,
      "voteCount": 1506976,
      "runtimeMinutes": 124
    },
    {
      "id": "tt0133093",
      "rank": 16,
      "type": "Movie",
      "year": 1999,
      "image": "https://m.media-amazon.com/images/M/MV5BN2NmN2VhMTQtMDNiOS00NDlhLTliMjgtODE2ZTY0ODQyNDRhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Matrix",
      "rating": 8.7,
      "voteCount": 2251813,
      "runtimeMinutes": 136
    },
    {
      "id": "tt0099685",
      "rank": 17,
      "type": "Movie",
      "year": 1990,
      "image": "https://m.media-amazon.com/images/M/MV5BN2E5NzI2ZGMtY2VjNi00YTRjLWI1MDUtZGY5OWU1MWJjZjRjXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "GoodFellas",
      "rating": 8.7,
      "voteCount": 1394403,
      "runtimeMinutes": 145
    },
    {
      "id": "tt0816692",
      "rank": 18,
      "type": "Movie",
      "year": 2014,
      "image": "https://m.media-amazon.com/images/M/MV5BYzdjMDAxZGItMjI2My00ODA1LTlkNzItOWFjMDU5ZDJlYWY3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Interstellar",
      "rating": 8.7,
      "voteCount": 2540166,
      "runtimeMinutes": 169
    },
    {
      "id": "tt0073486",
      "rank": 19,
      "type": "Movie",
      "year": 1975,
      "image": "https://m.media-amazon.com/images/M/MV5BYjBkMjgzMzYtNzRiMS00NDc3LWE4YTUtZjYxYjZhNjNhYzhhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "One Flew Over the Cuckoo's Nest",
      "rating": 8.6,
      "voteCount": 1157387,
      "runtimeMinutes": 133
    },
    {
      "id": "tt0114369",
      "rank": 20,
      "type": "Movie",
      "year": 1995,
      "image": "https://m.media-amazon.com/images/M/MV5BY2IzNzMxZjctZjUxZi00YzAxLTk3ZjMtODFjODdhMDU5NDM1XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Seven",
      "rating": 8.6,
      "voteCount": 2025905,
      "runtimeMinutes": 127
    },
    {
      "id": "tt0038650",
      "rank": 21,
      "type": "Movie",
      "year": 1946,
      "image": "https://m.media-amazon.com/images/M/MV5BMDM4OWFhYjEtNTE5Yy00NjcyLTg5N2UtZDQwNDZlYjlmNDU5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "It's a Wonderful Life",
      "rating": 8.6,
      "voteCount": 554350,
      "runtimeMinutes": 130
    },
    {
      "id": "tt0102926",
      "rank": 22,
      "type": "Movie",
      "year": 1991,
      "image": "https://m.media-amazon.com/images/M/MV5BNDdhOGJhYzctYzYwZC00YmI2LWI0MjctYjg4ODdlMDExYjBlXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Silence of the Lambs",
      "rating": 8.6,
      "voteCount": 1726180,
      "runtimeMinutes": 118
    },
    {
      "id": "tt0120815",
      "rank": 23,
      "type": "Movie",
      "year": 1998,
      "image": "https://m.media-amazon.com/images/M/MV5BZGZhZGQ1ZWUtZTZjYS00MDJhLWFkYjctN2ZlYjE5NWYwZDM2XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Saving Private Ryan",
      "rating": 8.6,
      "voteCount": 1642651,
      "runtimeMinutes": 169
    },
    {
      "id": "tt0047478",
      "rank": 24,
      "type": "Movie",
      "year": 1954,
      "image": "https://m.media-amazon.com/images/M/MV5BZjliMWExOTMtZDQ3ZS00NWU3LWIyN2EtMjllNzk3ZTNlYzg4XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Seven Samurai",
      "rating": 8.6,
      "voteCount": 402183,
      "runtimeMinutes": 207
    },
    {
      "id": "tt0120689",
      "rank": 25,
      "type": "Movie",
      "year": 1999,
      "image": "https://m.media-amazon.com/images/M/MV5BMTUxMzQyNjA5MF5BMl5BanBnXkFtZTYwOTU2NTY3._V1_QL75_UX200_.jpg",
      "title": "The Green Mile",
      "rating": 8.6,
      "voteCount": 1563823,
      "runtimeMinutes": 189
    }
  ],
  "total": 250,
  "hasMore": true,
  "nextPage": 2
}
```

---

### Coming Soon

IMDb Coming Soon — film/serial yang akan rilis (upcoming).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/coming-soon`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `type` | enum(movie|tv) | query | no | Jenis: movie atau tv. Default movie |
| `region` | string | query | no | Kode region 2 huruf (mis. US, ID, GB). Opsional |
| `limit` | number | query | no | Jumlah judul. Default 20, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/coming-soon?type=movie&region=US&limit=20" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/coming-soon?type=movie&region=US&limit=20", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/coming-soon?type=movie&region=US&limit=20",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "from": "2026-06-07",
  "type": "movie",
  "count": 20,
  "items": [
    {
      "id": "tt15047880",
      "cast": [
        "Emily Blunt",
        "Josh O'Connor",
        "Colin Firth",
        "Eve Hewson"
      ],
      "plot": "If you found out we weren't alone, if someone showed you, proved it to you, would that frighten you?",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BMTgwNDI1ZjctYWNmMS00MTJhLTg1ZWItMzI1Yjk5NjZkYWFkXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Disclosure Day",
      "genres": [
        "Drama",
        "Sci-Fi",
        "Thriller"
      ],
      "releaseDate": "2026-06-12"
    },
    {
      "id": "tt33764258",
      "cast": [
        "Anne Hathaway",
        "Josh Stewart",
        "Charlize Theron",
        "Zendaya"
      ],
      "plot": "After the Trojan War, Odysseus faces a dangerous voyage back to Ithaca, meeting creatures like the Cyclops Polyphemus, Sirens, and Calypso along the way.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BZDY2NTkxMWQtMmNkMC00NmNjLWIzMmItNmEyMmRmMDk2YmY2XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "The Odyssey",
      "genres": [
        "Adventure",
        "Drama",
        "Fantasy"
      ],
      "releaseDate": "2026-07-17"
    },
    {
      "id": "tt29355505",
      "cast": [
        "Tom Hanks",
        "Keanu Reeves",
        "Joan Cusack",
        "Annie Potts"
      ],
      "plot": "Woody, Buzz, Jessie and the rest of the gang's jobs are challenged when they're introduced to electronics, a new threat to playtime.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BZTI1YTBiNmEtYWUxZi00YzFkLWIzNjMtMmZjMmY2NzM0ZWMzXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Toy Story 5",
      "genres": [
        "Animation",
        "Adventure",
        "Comedy",
        "Drama",
        "Family",
        "Fantasy"
      ],
      "releaseDate": "2026-06-19"
    },
    {
      "id": "tt8814476",
      "cast": [
        "Milly Alcock",
        "Jason Momoa",
        "David Corenswet",
        "David Krumholtz"
      ],
      "plot": "Kara Zor-El, aka Supergirl, joins forces with an unlikely companion on an interstellar journey of vengeance and justice when an unexpected adversary strikes too close to home.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BNjlhMTdmODYtOGE0ZC00YzAwLWI1NDMtMTIzZDQzZGVkNDMwXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Supergirl",
      "genres": [
        "Action",
        "Adventure",
        "Drama",
        "Sci-Fi"
      ],
      "releaseDate": "2026-06-26"
    },
    {
      "id": "tt32273171",
      "cast": [
        "Hugh Jackman",
        "Jodie Comer",
        "Bill Skarsgård",
        "Jade Croot"
      ],
      "plot": "Grappling with his past after a life of crime and murder, Robin Hood finds himself gravely injured after a battle he thought would be his last. In the hands of a mysterious woman, he is offered a chance at salvation.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BYTRmNzlmZjEtYjkzMC00MmNjLThiOGYtZjM5MjFiZDQyM2IwXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "The Death of Robin Hood",
      "genres": [
        "Action",
        "Adventure",
        "Drama"
      ],
      "releaseDate": "2026-06-19"
    },
    {
      "id": "tt33311069",
      "cast": [
        "Miao Xie",
        "Joe Taslim",
        "Sahajak Boonthanakit",
        "Joey Iwanaga"
      ],
      "plot": "A father fights fiercely against ruthless kidnappers to save his abducted daughter.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BODUyZjg2YzctNGE3Yi00YjhhLTkyZTItZTAwZTNhNDA1ODQzXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "The Furious",
      "genres": [
        "Action",
        "Crime",
        "Thriller"
      ],
      "releaseDate": "2026-06-12"
    },
    {
      "id": "tt39143902",
      "cast": [
        "Joe Bird",
        "Stacy Clausen",
        "Jeremy Blewitt",
        "Ewen Leslie"
      ],
      "plot": "Two teenage boys must escape a violent entity that takes the form of the person they desire most - each other.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BZjVkZjIxMzItMzYyMi00ODMwLWEwMWQtMjhhMTkwMGI5MWEyXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Leviticus",
      "genres": [
        "Horror",
        "Romance",
        "Sci-Fi",
        "Thriller"
      ],
      "releaseDate": "2026-06-19"
    },
    {
      "id": "tt27419466",
      "cast": [
        "Catherine Laga'aia",
        "Dwayne Johnson",
        "John Tui",
        "Frankie Adams"
      ],
      "plot": "Live-action adaptation of the 2016 Disney animated film 'Moana.'",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BMTQ1OTQ2Y2UtMzllNS00ODFiLWFkNGItNGRjOWRlMjIwNTRlXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Moana",
      "genres": [
        "Action",
        "Adventure",
        "Comedy",
        "Family",
        "Fantasy",
        "Musical"
      ],
      "releaseDate": "2026-07-10"
    },
    {
      "id": "tt31170389",
      "cast": [
        "Luciane Buchanan",
        "Hunter Doohan",
        "Souheila Yacoub",
        "Tandi Wright"
      ],
      "plot": "After the loss of her husband, a woman seeks solace with her in-laws. As one by one they transform into deadites, she comes to discover that the vows she took in life - survive even in death.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BZTljMTZjZTItZjMzZi00NDBhLWFmMzAtOGNiNTlhY2MxMzg5XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Evil Dead Burn",
      "genres": [
        "Fantasy",
        "Horror",
        "Mystery"
      ],
      "releaseDate": "2026-07-10"
    },
    {
      "id": "tt32890033",
      "cast": [
        "Zoey Deutch",
        "Allison Janney",
        "Christoph Waltz",
        "Jeff Bridges"
      ],
      "plot": "Follows the Minions in 1920s Hollywood as they search for frightening creatures for their monster movie, partner with a green creature, and must save the planet after unleashing monsters.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BYzBjMDg4YjctYzg3ZS00ZDFmLWI1YjctM2RkZGVjZWEyYWQ0XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Minions & Monsters",
      "genres": [
        "Animation",
        "Adventure",
        "Comedy",
        "Crime",
        "Family",
        "Sci-Fi"
      ],
      "releaseDate": "2026-07-01"
    },
    {
      "id": "tt38128726",
      "cast": [
        "Brock Hayhoe",
        "Paul Scheer",
        "Symone",
        "Joel McHale"
      ],
      "plot": "Two train stewardess BFFs switch from a dull railway to the luxurious Glamazonian Express. During a massive storm, they must work with snooty first-class crew and President Gagwell to prevent disaster in LA.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BYmM2MmJkMDEtYjc2Yi00NGMzLWExYjAtMjQzN2RiNzkwZWE3XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Stop! That! Train!",
      "genres": [
        "Action",
        "Comedy"
      ],
      "releaseDate": "2026-06-12"
    },
    {
      "id": "tt34688195",
      "cast": [
        "Angelina Jolie",
        "Anyier Anei",
        "Ella Rumpf",
        "Louis Garrel"
      ],
      "plot": "An American filmmaker arrives in Paris for Fashion Week on a life-and-death journey, facing challenges and self-discovery.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BNzMwNzY0NzEtNjQyOS00MDNiLTkzYWMtNGNjNmQyNmU2MDI1XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Couture",
      "genres": [
        "Drama"
      ],
      "releaseDate": "2026-06-26"
    },
    {
      "id": "tt32321803",
      "cast": [
        "Russell Crowe",
        "Luke Evans",
        "Teresa Palmer",
        "Aaron Paul"
      ],
      "plot": "A nightclub owner is on the verge of leaving his dangerous past behind for retirement. After masked gunmen rob him and he finds himself squeezed by ruthless cartels, a mysterious newcomer arrives with an interest in buying the business.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BYjYyODEwZjQtYWRjMy00OTc1LWFlYzktYjI1MTE3YjhlNDMzXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "The Get Out",
      "genres": [
        "Action",
        "Thriller"
      ],
      "releaseDate": "2026-06-26"
    },
    {
      "id": "tt28540171",
      "cast": [
        "Akshay Kumar",
        "Disha Patani",
        "Zakir Hussain",
        "Urvashi Rautela"
      ],
      "plot": "Police officers Jay Bakshi and Sandhya hunt notorious criminal Raj Solanki, but Jai discovers Raj has an important connection to his own life.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BMTY5ODUxNDctZGJjNC00OTk0LWIzMzAtMWQ5NTAyMGZhY2NmXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Welcome to the Jungle",
      "genres": [
        "Action",
        "Adventure",
        "Comedy",
        "Crime"
      ],
      "releaseDate": "2026-06-26"
    },
    {
      "id": "tt33219707",
      "cast": [
        "Bailee Madison",
        "Annie Potts",
        "Joel Courtney",
        "Eric Nelsen"
      ],
      "plot": "A struggling romantic accepts her aunt's wager: go on 40 dates in 40 nights to find true love. If she fails, her aunt will cover her rent and student debt. But the journey proves more challenging than expected.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BYTkwY2YxOTItN2EyYi00Yjc3LTlmYTYtZWY0Y2M1MGQyZjdhXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "40 Dates and 40 Nights",
      "genres": [
        "Comedy",
        "Romance"
      ],
      "releaseDate": "2026-06-26"
    },
    {
      "id": "tt32104007",
      "cast": [
        "Andy Serkis",
        "Ben Kingsley",
        "Mary-Louise Parker",
        "Kelsey Grammer"
      ],
      "plot": "Before he led a nation, George Washington was a young soldier thrown into a global conflict. With alliances crumbling and war closing in, he must choose who to trust and confront the leader he's becoming.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BNTE3NDY5OWUtZmM5Ny00NDJiLTlkZDQtN2E5MWFjZWUyMDZkXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Young Washington",
      "genres": [
        "Action",
        "Biography",
        "Drama",
        "History",
        "War"
      ],
      "releaseDate": "2026-07-03"
    },
    {
      "id": "tt39316472",
      "cast": [
        "Spike Jonze",
        "Johnny Knoxville",
        "Bam Margera",
        "Adam Ray"
      ],
      "plot": "Follows the Jackass crew as they perform their final series of dangerous stunts and pranks, marking the end of the franchise.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BYTRlYzQwYjItNDljNC00YmI2LWEwYmEtMjhhM2NiMGFhNTYyXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Jackass: Best and Last",
      "genres": [
        "Documentary",
        "Comedy"
      ],
      "releaseDate": "2026-06-26"
    },
    {
      "id": "tt32432654",
      "cast": [
        "Maya da Costa",
        "Myra Molloy",
        "Zach Braff",
        "Levon Hawke"
      ],
      "plot": "Coley, 17, from rural Oregon, navigates intimacy after her mother's passing. Meeting Sonya sparks new feelings, but self-doubt hinders their connection. Sonya, unfamiliar with dating girls, is uncertain. They learn to embrace emotions",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BNzAwYmRjMzMtNTdkNC00Yzk5LTllZDYtMWRiZGZkNWY2NzMwXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Girls Like Girls",
      "genres": [
        "Drama"
      ],
      "releaseDate": "2026-06-19"
    },
    {
      "id": "tt36834010",
      "cast": [
        "Jon Hamm",
        "Kerri Kenney",
        "Zoey Deutch",
        "Ken Marino"
      ],
      "plot": "When her fiancé uses their \"celebrity pass\" agreement, Midwest bride Gail Daughtry travels to Hollywood seeking revenge by pursuing her own celebrity encounter.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BZTFjOGJhNzEtMWUxMC00Yjc1LWE1MTUtODc4Yzk3MzVjMWUyXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Gail Daughtry and the Celebrity Sex Pass",
      "genres": [
        "Comedy"
      ],
      "releaseDate": "2026-07-10"
    },
    {
      "id": "tt35309713",
      "cast": [
        "Armie Hammer",
        "Costas Mandylor",
        "Dora Dimic Rakar",
        "Vjekoslav Katusin"
      ],
      "plot": "A man takes justice into his own hands, hunting down criminals. His vigilante crusade makes him a social media star but puts him at odds with the local police chief.",
      "type": "Movie",
      "image": "https://m.media-amazon.com/images/M/MV5BN2FjZjE2YmUtNjE2NS00ZjcyLWEwMzUtZGYwNzI0ZWQxODVlXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Citizen Vigilante",
      "genres": [
        "Action",
        "Thriller"
      ],
      "releaseDate": "2026-06-19"
    }
  ],
  "region": "US"
}
```

---

### Credits

IMDb Credits — daftar lengkap pemeran & kru sebuah title (paginated).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/credits/:id`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | IMDb title ID (tt…) atau URL title penuh |
| `page` | number | query | no | Halaman (1,2,3…). Default 1, max 30 |
| `count` | number | query | no | Jumlah kredit per halaman. Default 25, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/credits/:id?page=1&count=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/credits/:id?page=1&count=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/credits/:id?page=1&count=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "tt1375666",
  "page": 1,
  "count": 25,
  "title": "Inception",
  "total": 1603,
  "credits": [
    {
      "id": "nm0000138",
      "name": "Leonardo DiCaprio",
      "image": "https://m.media-amazon.com/images/M/MV5BMjI0MTg3MzI0M15BMl5BanBnXkFtZTcwMzQyODU2Mw@@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Cobb"
      ]
    },
    {
      "id": "nm0330687",
      "name": "Joseph Gordon-Levitt",
      "image": "https://m.media-amazon.com/images/M/MV5BMTY3NTk0NDI3Ml5BMl5BanBnXkFtZTgwNDA3NjY0MjE@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Arthur"
      ]
    },
    {
      "id": "nm0680983",
      "name": "Elliot Page",
      "image": "https://m.media-amazon.com/images/M/MV5BZmM3ZjE2M2QtYzljOC00ZTI4LWFhNTItOWVhNTkzM2JhOTE3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Ariadne"
      ]
    },
    {
      "id": "nm0362766",
      "name": "Tom Hardy",
      "image": "https://m.media-amazon.com/images/M/MV5BMTQ3ODEyNjA4Nl5BMl5BanBnXkFtZTgwMTE4ODMyMjE@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Eames"
      ]
    },
    {
      "id": "nm0913822",
      "name": "Ken Watanabe",
      "image": "https://m.media-amazon.com/images/M/MV5BMTQzMTUzNjc4Nl5BMl5BanBnXkFtZTcwMTUyODU2Mw@@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Saito"
      ]
    },
    {
      "id": "nm2438307",
      "name": "Dileep Rao",
      "image": "https://m.media-amazon.com/images/M/MV5BMTI5Nzc2NTc2MF5BMl5BanBnXkFtZTcwMDM2MTc1Mg@@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Yusuf"
      ]
    },
    {
      "id": "nm0614165",
      "name": "Cillian Murphy",
      "image": "https://m.media-amazon.com/images/M/MV5BNWM3NTg0NGYtNTFmYS00OWY1LTlkNTgtNzZlMWY4OGRmMmEzXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Robert Fischer, Jr."
      ]
    },
    {
      "id": "nm0000297",
      "name": "Tom Berenger",
      "image": "https://m.media-amazon.com/images/M/MV5BMTk1OTQ5MzUzM15BMl5BanBnXkFtZTgwMDUxMTY1NDE@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Browning"
      ]
    },
    {
      "id": "nm0182839",
      "name": "Marion Cotillard",
      "image": "https://m.media-amazon.com/images/M/MV5BMTQxNTEzNTkwNF5BMl5BanBnXkFtZTcwNzQ2NDIwOQ@@._V1_QL75_UX200_.jpg",
      "category": "Actress",
      "characters": [
        "Mal"
      ]
    },
    {
      "id": "nm0000592",
      "name": "Pete Postlethwaite",
      "image": "https://m.media-amazon.com/images/M/MV5BMTMyMjIxMTQ2NV5BMl5BanBnXkFtZTYwNDQ0NTE1._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Maurice Fischer"
      ]
    },
    {
      "id": "nm0000323",
      "name": "Michael Caine",
      "image": "https://m.media-amazon.com/images/M/MV5BMjAwNzIwNTQ4Ml5BMl5BanBnXkFtZTYwMzE1MTUz._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Miles"
      ]
    },
    {
      "id": "nm0001305",
      "name": "Lukas Haas",
      "image": "https://m.media-amazon.com/images/M/MV5BMTQ3MjU1MDMxM15BMl5BanBnXkFtZTgwODk5ODE4MDE@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Nash"
      ]
    },
    {
      "id": "nm2581730",
      "name": "Tai-Li Lee",
      "image": null,
      "category": "Actor",
      "characters": [
        "Tadashi"
      ]
    },
    {
      "id": "nm3637500",
      "name": "Claire Geare",
      "image": "https://m.media-amazon.com/images/M/MV5BMGQ0ODdlOGUtYmJhYi00NmZkLTg3OGQtN2FiY2NiNTRjYmY3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actress",
      "characters": [
        "Phillipa (3 Years)"
      ]
    },
    {
      "id": "nm3960408",
      "name": "Magnus Nolan",
      "image": "https://m.media-amazon.com/images/M/MV5BN2RhZmYwMTEtZjhhYy00ZDI4LTk2ZGUtNjhhYjA4ODdhNmYzXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "James (20 Months)"
      ]
    },
    {
      "id": "nm2855622",
      "name": "Taylor Geare",
      "image": "https://m.media-amazon.com/images/M/MV5BNTBjMDgyMDgtMjE5Yi00OTExLWIwYjQtOTllNGU5ZDI4YzdhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actress",
      "characters": [
        "Phillipa (5 Years)"
      ]
    },
    {
      "id": "nm3638213",
      "name": "Johnathan Geare",
      "image": null,
      "category": "Actor",
      "characters": [
        "James (3 Years)"
      ]
    },
    {
      "id": "nm0556070",
      "name": "Tohoru Masamune",
      "image": "https://m.media-amazon.com/images/M/MV5BNWUxYWQwZWMtZDUyMi00MmVkLTlhNzctNzU2NGQ0NDAxMjk3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Japanese Security Guard"
      ]
    },
    {
      "id": "nm0645785",
      "name": "Yuji Okumoto",
      "image": "https://m.media-amazon.com/images/M/MV5BNzQzMWIxYTMtY2MxNy00ZTU4LTg2NmMtMjU5ODc2YTU4NDFkXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Saito's Attendant"
      ]
    },
    {
      "id": "nm0131565",
      "name": "Earl Cameron",
      "image": "https://m.media-amazon.com/images/M/MV5BMTk3NzEyMTI5MV5BMl5BanBnXkFtZTcwNDgxNDIzOA@@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Elderly Bald Man"
      ]
    },
    {
      "id": "nm1147074",
      "name": "Ryan Hayward",
      "image": "https://m.media-amazon.com/images/M/MV5BMzU3ODM2ZWUtMjIyMS00ZGY5LTllNTQtMjNkNTFjOGI2NmZhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Lawyer"
      ]
    },
    {
      "id": "nm3886541",
      "name": "Miranda Nolan",
      "image": "https://m.media-amazon.com/images/M/MV5BODI3NmQ5MzktOTQ1Ny00NTRiLThiNGUtM2E3Mjg2ZjliNmU3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "category": "Actress",
      "characters": [
        "Flight Attendant"
      ]
    },
    {
      "id": "nm0270383",
      "name": "Russ Fega",
      "image": "https://m.media-amazon.com/images/M/MV5BMTMzNDE5MjI2MV5BMl5BanBnXkFtZTYwOTgwNzcy._V1_QL75_UX200_.jpg",
      "category": "Actor",
      "characters": [
        "Cab Driver"
      ]
    },
    {
      "id": "nm0445551",
      "name": "Tim Kelleher",
      "image": null,
      "category": "Actor",
      "characters": [
        "Thin Man"
      ]
    },
    {
      "id": "nm1506908",
      "name": "Talulah Riley",
      "image": "https://m.media-amazon.com/images/M/MV5BMjE0MzUwNTUxM15BMl5BanBnXkFtZTcwNzU1OTY5Ng@@._V1_QL75_UX200_.jpg",
      "category": "Actress",
      "characters": [
        "Blonde"
      ]
    }
  ],
  "hasMore": true,
  "nextPage": 2
}
```

---

### Episodes

IMDb Episodes — daftar episode sebuah serial TV (opsional per-season, paginated).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/episodes/:id`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | IMDb series ID (tt…, Breaking Bad) atau URL penuh |
| `season` | string | query | no | Nomor season (mis. 1). Kosongkan untuk ambil semua episode lintas-season |
| `page` | number | query | no | Halaman (1,2,3…). Default 1, max 30 |
| `count` | number | query | no | Jumlah episode per halaman. Default 25, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/episodes/:id?season=1&page=1&count=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/episodes/:id?season=1&page=1&count=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/episodes/:id?season=1&page=1&count=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "tt0903747",
  "page": 1,
  "count": 7,
  "total": 7,
  "season": "1",
  "series": "Breaking Bad",
  "hasMore": false,
  "episodes": [
    {
      "id": "tt0959621",
      "plot": "Facing a life-altering diagnosis, chemistry teacher Walter White teams with former student Jesse Pinkman to cook meth, hoping to secure his family's future.",
      "image": "https://m.media-amazon.com/images/M/MV5BZGU1MDVlOWItMGVhNy00MmNlLWE1NjktMTM0M2UwMjAzZTQzXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Pilot",
      "rating": 9,
      "season": "1",
      "episode": "1",
      "voteCount": 81558,
      "releaseDate": "2008-01-20"
    },
    {
      "id": "tt1054724",
      "plot": "Walt and Jesse face the messy fallout from their first cook, scrambling to erase evidence and deal with a dangerous loose end as Skyler grows uneasy over Walt's secretive behavior.",
      "image": "https://m.media-amazon.com/images/M/MV5BNTFlNzk3MTQtYTdjMC00NjIwLWI1ZDItZDQ1MTVjMTljMGRjXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Cat's in the Bag...",
      "rating": 8.6,
      "season": "1",
      "episode": "2",
      "voteCount": 60689,
      "releaseDate": "2008-01-27"
    },
    {
      "id": "tt1054725",
      "plot": "With a dangerous captive in Jesse's basement, Walt faces a moral dilemma while scrambling to cover his tracks at home and keep their fledgling operation alive.",
      "image": "https://m.media-amazon.com/images/M/MV5BMzUwZGQzZmMtYzgyYS00ZWZjLWI5NzgtZTk4YzNiOGRjOGI3XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "...And the Bag's in the River",
      "rating": 8.7,
      "season": "1",
      "episode": "3",
      "voteCount": 58476,
      "releaseDate": "2008-02-10"
    },
    {
      "id": "tt1054726",
      "plot": "After Walter's cancer diagnosis, a fraught family intervention pushes him to decide about treatment. With money tight, he and Jesse consider their next step in the meth business -- despite the growing risks.",
      "image": "https://m.media-amazon.com/images/M/MV5BYWY0YzlmYmYtZmIxMC00Yjg3LTgzYjgtNWYyMDIxZWVlYzkyXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Cancer Man",
      "rating": 8.2,
      "season": "1",
      "episode": "4",
      "voteCount": 56198,
      "releaseDate": "2008-02-17"
    },
    {
      "id": "tt1054727",
      "plot": "Walt considers how to pay for his cancer treatment after reconnecting with former partners who offer help, while Jesse tries to expand their customer base.",
      "image": "https://m.media-amazon.com/images/M/MV5BZDMxZDE1MjQtMjI0MC00M2Y1LWI5YmMtNDdkZmFmZmVhYWE3XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Gray Matter",
      "rating": 8.2,
      "season": "1",
      "episode": "5",
      "voteCount": 55155,
      "releaseDate": "2008-02-24"
    },
    {
      "id": "tt1054728",
      "plot": "Burned by a crooked deal, Walt summons the nerve to confront the underworld and line up a new distributor, while Jesse scrambles to unload their stash and keep their operation under the radar.",
      "image": "https://m.media-amazon.com/images/M/MV5BNmVkNjg5ZjEtZGFkYy00MzQzLWE2NGEtNjg5MWQyY2QxMzM2XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Crazy Handful of Nothin'",
      "rating": 9.3,
      "season": "1",
      "episode": "6",
      "voteCount": 64450,
      "releaseDate": "2008-03-02"
    },
    {
      "id": "tt1054729",
      "plot": "Under pressure from a dangerous new customer, Walt and Jesse scramble to expand their meth operation, devising a risky plan to secure supplies as Walt tries to keep his double life from Skyler.",
      "image": "https://m.media-amazon.com/images/M/MV5BNzM1OTA1NzgxOV5BMl5BanBnXkFtZTgwMjg2MDU5NTM@._V1_QL75_UX300_.jpg",
      "title": "A No-Rough-Stuff-Type Deal",
      "rating": 8.8,
      "season": "1",
      "episode": "7",
      "voteCount": 56131,
      "releaseDate": "2008-03-09"
    }
  ],
  "nextPage": null
}
```

---

### Filmography

IMDb Filmography — daftar kredit film/serial seorang aktor/kru (paginated).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/filmography/:id`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | IMDb name ID (nm…) atau URL name penuh |
| `page` | number | query | no | Halaman (1,2,3…). Default 1, max 30 |
| `count` | number | query | no | Jumlah kredit per halaman. Default 25, max 50 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/filmography/:id?page=1&count=25" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/filmography/:id?page=1&count=25", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/filmography/:id?page=1&count=25",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "nm0000138",
  "name": "Leonardo DiCaprio",
  "page": 1,
  "count": 25,
  "total": 608,
  "credits": [
    {
      "id": "tt38985296",
      "type": "Movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BZmEwNzU4MWEtZGMzMy00NzA0LWIzYWItN2E1ODQ0MmZhYzA0XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Oz",
      "category": "Producer"
    },
    {
      "id": "tt29028861",
      "type": "Movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BYjUzM2FhZDQtNDBmZC00ZTU2LWE3YjUtNGU4NjAzOTRkYzllXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Michael Caton-Jones: This Broxburn Boy's Life",
      "category": "Archive Footage",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt39796043",
      "type": "Movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BMTJjMTY0ZGUtZDJmYS00YTM1LTk1YTEtODE2YzVmZTM3ZmU3XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Death Boom",
      "category": "Producer"
    },
    {
      "id": "tt42437989",
      "type": "TV Special",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BOWRkZjQzOWMtZGVlMi00MWM4LTk4MGYtMzMyZmMzOTZlMTBmXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "David Attenborough's 100 Years on Planet Earth",
      "rating": 8.3,
      "category": "Self",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt39314348",
      "type": "Movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BOWI2NWRhNjMtNDBiOC00YTUzLTgzNTgtNWIwOTM5N2I0MWRhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "A Gorilla Story: Told by David Attenborough",
      "rating": 8,
      "category": "Producer"
    },
    {
      "id": "tt0081857",
      "type": "TV Series",
      "year": 1981,
      "image": "https://m.media-amazon.com/images/M/MV5BYmEzODg2ZjctZDIzMC00ZjE4LTg2M2UtMjI5ZmJhYWRmMjFkXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Entertainment Tonight",
      "rating": 3.6,
      "category": "Archive Footage",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt1215594",
      "type": "TV Series",
      "year": 1984,
      "image": "https://m.media-amazon.com/images/M/MV5BNTRmMWI5YmEtMmI2OS00ZjkzLWFmNmMtMjY0YWNiYWI5NTcxXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Dateline",
      "rating": 6.9,
      "category": "Archive Footage",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt3310362",
      "type": "TV Series",
      "year": 2008,
      "image": "https://m.media-amazon.com/images/M/MV5BOGFkNzRkM2QtOTdjMS00NWI4LTg5MmUtYzNiNjczMGFhNmFhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "ABC News Breakfast",
      "rating": 4.7,
      "category": "Archive Footage",
      "characters": [
        "Self - Actor",
        "One Battle After Another",
        "Self - Actor, Titanic"
      ]
    },
    {
      "id": "tt1170244",
      "type": "TV Series",
      "year": 2007,
      "image": "https://m.media-amazon.com/images/M/MV5BZDlmMjQ1NTgtNjgwNi00ZTFjLTljMjktZjk4NjMzOGMxNjE5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Morning Joe",
      "rating": 4,
      "category": "Archive Footage",
      "characters": [
        "Self -",
        "Pat Calhoun"
      ]
    },
    {
      "id": "tt1853460",
      "type": "TV Series",
      "year": 2009,
      "image": "https://m.media-amazon.com/images/M/MV5BN2I1ZTAxMmQtODViNi00MTNkLWI0MDUtNWU5YTcxNjkwYTJjXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Way Too Early with Ali Vitali",
      "rating": 3.8,
      "category": "Archive Footage",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt0320037",
      "type": "TV Series",
      "year": 2003,
      "image": "https://m.media-amazon.com/images/M/MV5BN2M1OGJiOTctNDg2Yi00M2I1LThjMTktY2NhN2VjZWU2NDllXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Jimmy Kimmel Live!",
      "rating": 6.4,
      "category": "Self",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt34358231",
      "type": "Movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BNTEwMzJjYjItYTlhMC00MjU0LWIyYWYtNTM4ZTM5YWY2ODU5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Serling",
      "category": "Producer"
    },
    {
      "id": "tt36205360",
      "type": "TV Special",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BYjU0MDUwNzQtYThlYS00ODJkLTk2MGMtYjFlMWJjMTk1YmE2XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Oscars",
      "rating": 6.5,
      "category": "Self",
      "characters": [
        "Self - Nominee"
      ]
    },
    {
      "id": "tt1170244",
      "type": "TV Series",
      "year": 2007,
      "image": "https://m.media-amazon.com/images/M/MV5BZDlmMjQ1NTgtNjgwNi00ZTFjLTljMjktZjk4NjMzOGMxNjE5XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Morning Joe",
      "rating": 4,
      "category": "Self",
      "characters": [
        "Self - Bob Ferguson"
      ]
    },
    {
      "id": "tt38672206",
      "type": "TV Series",
      "year": 1993,
      "image": "https://m.media-amazon.com/images/M/MV5BMmI0OWVkYmEtN2M1Ny00MGQzLThkMmUtZmFiZWRiZmQ1NWZjXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "VOX Nachrichten",
      "rating": 3.3,
      "category": "Self",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt36951281",
      "type": "TV Series",
      "year": 1980,
      "image": "https://m.media-amazon.com/images/M/MV5BNmU5NzFlZDUtZWQ4YS00ZWIxLWExNTktNDRlZTA5OGY0MzIwXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "NTV Evening Newshour",
      "category": "Archive Footage",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt39059938",
      "type": "TV Special",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BMjI1N2FmNmQtNThhZS00OTg2LWEzMzUtODQ0NjM4MmFiNGQ4XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "2026 EE BAFTA Film Awards",
      "rating": 5.7,
      "category": "Self",
      "characters": [
        "Self - Nominee"
      ]
    },
    {
      "id": "tt7336664",
      "type": "TV Series",
      "year": 1968,
      "image": "https://m.media-amazon.com/images/M/MV5BYmIzMTdhMzktYTE5Ni00MWFiLWJkNWMtMDdlZTY4OWY4MTFjXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Vremya",
      "rating": 3.1,
      "category": "Archive Footage",
      "characters": [
        "Self - Actor"
      ]
    },
    {
      "id": "tt0167515",
      "type": "TV Series",
      "year": 1996,
      "image": "https://m.media-amazon.com/images/M/MV5BNzU2MWUxN2MtNjQzMi00MDg4LTk3NWUtNThhYmMxMWNjNDc4XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Access Hollywood",
      "rating": 3.2,
      "category": "Archive Footage",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt34577866",
      "type": "Movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BZmI2MzczYzgtOTEwZS00ZDllLTg1ZDUtZjRiMGFiMjYxN2QwXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Lake",
      "rating": 7,
      "category": "Producer"
    },
    {
      "id": "tt0167515",
      "type": "TV Series",
      "year": 1996,
      "image": "https://m.media-amazon.com/images/M/MV5BNzU2MWUxN2MtNjQzMi00MDg4LTk3NWUtNThhYmMxMWNjNDc4XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Access Hollywood",
      "rating": 3.2,
      "category": "Self",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt0247094",
      "type": "TV Series",
      "year": 1994,
      "image": "https://m.media-amazon.com/images/M/MV5BZWI4ZDRkOWQtNzI2OC00MDdlLWIwNDEtYzcwYzRmZmVkYTVmXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Extra",
      "rating": 3.3,
      "category": "Self",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt0166442",
      "type": "TV Series",
      "year": 1988,
      "image": "https://m.media-amazon.com/images/M/MV5BMDZlNzBkOTQtNzk4NC00YzVjLWIyYjMtZjUzMTNhMjljMjlhXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Inside Edition",
      "rating": 4.1,
      "category": "Archive Footage",
      "characters": [
        "Self",
        "Jordan Belfort"
      ]
    },
    {
      "id": "tt0863054",
      "type": "TV Series",
      "year": 1957,
      "image": "https://m.media-amazon.com/images/M/MV5BMWU2MmY4NjgtZWM5Yi00OTJkLTlmMDItZGRjMTg2ODU2NDJmXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Times in Pictures",
      "rating": 5.9,
      "category": "Self",
      "characters": [
        "Self"
      ]
    },
    {
      "id": "tt1342151",
      "type": "TV Series",
      "year": 1975,
      "image": "https://m.media-amazon.com/images/M/MV5BYzlhMzBkMDUtMzdlZi00Y2Q3LWIwMzUtMDczZWRmYjdkYmMyXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "ZiB 2",
      "rating": 6.8,
      "category": "Self",
      "characters": [
        "Self"
      ]
    }
  ],
  "hasMore": true,
  "nextPage": 2
}
```

---

### Name

IMDb Name (Person) Detail — info aktor/sutradara/kru by IMDb ID (nm…).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/name/:id`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | IMDb name ID (diawali `nm`). Boleh tempel URL IMDb penuh — ID di-ekstrak otomatis |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/name/:id" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/name/:id", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/name/:id",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "nm0000138",
  "bio": "Few actors in the world have had a career quite as diverse as Leonardo DiCaprio's. DiCaprio has gone from relatively humble beginnings, as a supporting cast member of the sitcom Growing Pains (1985) and low budget horror movies, such as Critters 3 (1991), to a major teenage heartthrob in the 1990s, as the hunky lead actor in movies such as Romeo + Juliet (1996) and Titanic (1997), to then become a leading man in Hollywood blockbusters, made by internationally renowned directors such as Martin Scorsese and Christopher Nolan.\n\nLeonardo Wilhelm DiCaprio was born in Los Angeles, California, the only child of Irmelin DiCaprio (née Indenbirken) and former comic book artist George DiCaprio. His father is of Italian and German descent, and his mother, who is German-born, is of German, Ukrainian and Russian ancestry. His middle name, \"Wilhelm\", was his maternal grandfather's first name. Leonardo's father had achieved minor status as an artist and distributor of cult comic book titles, and was even depicted in several issues of American Splendor, the cult semi-autobiographical comic book series by the late 'Harvey Pekar', a friend of George's. Leonardo's performance skills became obvious to his parents early on, and after signing him up with a talent agent who wanted Leonardo to perform under the stage name \"Lenny Williams\", DiCaprio began appearing on a number of television commercials and educational programs.\n\nDiCaprio began attracting the attention of producers, who cast him in small roles in a number of television series, such as Roseanne (1988) and The New Lassie (1989), but it wasn't until 1991 that DiCaprio made his film debut in Critters 3 (1991), a low-budget horror movie. While Critters 3 (1991) did little to help showcase DiCaprio's acting abilities, it did help him develop his show-reel, and attract the attention of the people behind the hit sitcom Growing Pains (1985), in which Leonardo was cast in the \"Cousin Oliver\" role of a young homeless boy who moves in with the Seavers. While DiCaprio's stint on Growing Pains (1985) was very short, as the sitcom was axed the year after he joined, it helped bring DiCaprio into the public's attention and, after the sitcom ended, DiCaprio began auditioning for roles in which he would get the chance to prove his acting chops.\n\nLeonardo took up a diverse range of roles in the early 1990s, including a mentally challenged youth in What's Eating Gilbert Grape (1993), a young gunslinger in The Quick and the Dead (1995) and a drug addict in one of his most challenging roles to date, Jim Carroll in The Basketball Diaries (1995), a role which the late River Phoenix originally expressed interest in. While these diverse roles helped establish Leonardo's reputation as an actor, it wasn't until his role as Romeo Montague in Baz Luhrmann's Romeo + Juliet (1996) that Leonardo became a household name, a true movie star. The following year, DiCaprio starred in another movie about doomed lovers, Titanic (1997), which went on to beat all box office records held before then, as, at the time, Titanic (1997) became the highest grossing movie of all time, and cemented DiCaprio's reputation as a teen heartthrob. Following his work on Titanic (1997), DiCaprio kept a low profile for a number of years, with roles in The Man in the Iron Mask (1998) and the low-budget The Beach (2000) being some of his few notable roles during this period.\n\nIn 2002, he burst back into screens throughout the world with leading roles in Catch Me If You Can (2002) and Gangs of New York (2002), his first of many collaborations with director Martin Scorsese. With a current salary of $20 million a movie, DiCaprio is now one of the biggest movie stars in the world. However, he has not limited his professional career to just acting in movies, as DiCaprio is a committed environmentalist, who is actively involved in many environmental causes, and his commitment to this issue led to his involvement in The 11th Hour, a documentary movie about the state of the natural environment. As someone who has gone from small roles in television commercials to one of the most respected actors in the world, DiCaprio has had one of the most diverse careers in cinema. DiCaprio continued to defy conventions about the types of roles he would accept, and with his career now seeing him leading all-star casts in action thrillers such as The Departed (2006), Shutter Island (2010) and Christopher Nolan's Inception (2010), DiCaprio continues to wow audiences by refusing to conform to any cliché about actors.\n\nIn 2012, he played a mustache twirling villain in Django Unchained (2012), and then tragic literary character Jay Gatsby in The Great Gatsby (2013) and Jordan Belfort in The Wolf of Wall Street (2013).\n\nDiCaprio is passionate about environmental and humanitarian causes, having donated $1,000,000 to earthquake relief efforts in 2010, the same year he contributed $1,000,000 to the Wildlife Conservation Society.",
  "url": "https://www.imdb.com/name/nm0000138/",
  "name": "Leonardo DiCaprio",
  "photo": "https://m.media-amazon.com/images/M/MV5BMjI0MTg3MzI0M15BMl5BanBnXkFtZTcwMzQyODU2Mw@@._V1_QL75_UX600_.jpg",
  "knownFor": [
    {
      "id": "tt1375666",
      "year": 2010,
      "image": "https://m.media-amazon.com/images/M/MV5BMjAxMzY3NjcxNF5BMl5BanBnXkFtZTcwNTI5OTM0Mw@@._V1_QL75_UX200_.jpg",
      "title": "Inception",
      "rating": 8.8
    },
    {
      "id": "tt0407887",
      "year": 2006,
      "image": "https://m.media-amazon.com/images/M/MV5BMTI1MTY2OTIxNV5BMl5BanBnXkFtZTYwNjQ4NjY3._V1_QL75_UX200_.jpg",
      "title": "The Departed",
      "rating": 8.5
    },
    {
      "id": "tt0993846",
      "year": 2013,
      "image": "https://m.media-amazon.com/images/M/MV5BMjIxMjgxNTk0MF5BMl5BanBnXkFtZTgwNjIyOTg2MDE@._V1_QL75_UX200_.jpg",
      "title": "The Wolf of Wall Street",
      "rating": 8.2
    },
    {
      "id": "tt0120338",
      "year": 1997,
      "image": "https://m.media-amazon.com/images/M/MV5BYzYyN2FiZmUtYWYzMy00MzViLWJkZTMtOGY1ZjgzNWMwN2YxXkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Titanic",
      "rating": 8
    },
    {
      "id": "tt1130884",
      "year": 2010,
      "image": "https://m.media-amazon.com/images/M/MV5BN2FjNWExYzEtY2YzOC00YjNlLTllMTQtNmIwM2Q1YzBhOWM1XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "Shutter Island",
      "rating": 8.2
    },
    {
      "id": "tt0338751",
      "year": 2004,
      "image": "https://m.media-amazon.com/images/M/MV5BYTUyYWJlNDgtOTM5Ny00YTQ3LWFmYTgtZjJiNTNkYjJlMmY4XkEyXkFqcGc@._V1_QL75_UX200_.jpg",
      "title": "The Aviator",
      "rating": 7.5
    }
  ],
  "birthDate": "1974-11-11",
  "birthPlace": "Hollywood, Los Angeles, California, USA",
  "alsoKnownAs": [
    "Leonardo Di Caprio",
    "Leo DiCaprio"
  ],
  "professions": [
    "Producer",
    "Actor",
    "Writer"
  ],
  "photoOriginal": "https://m.media-amazon.com/images/M/MV5BMjI0MTg3MzI0M15BMl5BanBnXkFtZTcwMzQyODU2Mw@@._V1_.jpg",
  "popularityRank": 91
}
```

---

### Reviews

IMDb Reviews — ulasan pengguna untuk sebuah title (paginated + sortable).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/reviews/:id`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | IMDb title ID (tt…) atau URL title penuh |
| `sort` | enum(helpfulness|date|rating|votes) | query | no | Urutan: helpfulness, date (terbaru), rating, votes. Default helpfulness |
| `page` | number | query | no | Halaman (1,2,3…). Default 1, max 20 |
| `count` | number | query | no | Jumlah ulasan per halaman. Default 10, max 25 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/reviews/:id?sort=helpfulness&page=1&count=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/reviews/:id?sort=helpfulness&page=1&count=10", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/reviews/:id?sort=helpfulness&page=1&count=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "tt1375666",
  "page": 1,
  "sort": "helpfulness",
  "count": 10,
  "title": "Inception",
  "total": 5174,
  "hasMore": true,
  "reviews": [
    {
      "id": "rw10607352",
      "date": "2025-07-01",
      "title": "The one that stays with you long after the movie ended.",
      "author": "Didako1221",
      "rating": 10,
      "review": "Few films leave you genuinely questioning whether you truly understood them quite like Inception does. The cast is outstanding, the story itself feels like a puzzle you can't stop trying to solve, and the music subtly pulls you deeper without overpowering the experience. All of this has drawn me back to watch the movie at least five times over the years - and I know I'm not done yet.\n\nI've always admired Leonardo DiCaprio, and in this film, it feels like he poured everything he had into the role. All that's left for me now is to keep hoping that someday, we'll get a second part.\n\nSo, keep dreaming....",
      "upVotes": 143,
      "downVotes": 8
    },
    {
      "id": "rw4692192",
      "date": "2019-03-01",
      "title": "A one-of-a-kind mind-blowing masterpiece!",
      "author": "adrien_ngoc_1701",
      "rating": 10,
      "review": "My 3rd time watching this movie! Yet, it still stunned my mind, kept me enjoyed its every moment and left me with many thoughts afterward.\n\nFor someone like me, who've rarely slept without dream, it's so exciting watching how Christopher Nolan had illustrated every single characteristic of dream on the big screen. As it's been done so sophisticatedly, I do believe the rumour that Nolan had spent 10 years to finish the script of Inception. In my opinion, it's been so far the greatest achievement in his brilliant writer-director career. I jumped into this conclusion after making a quick benchmark of Nolan's remarkable works: \n* Memento, as his first signature in the cinema history, is tremendous and has stayed the most mind-bending film I've ever seen. But overall, it doesn't reach the same level of Inception.\n* The Prestige is highly impressive but somehow I haven't been able to find the very particular \"Nolan's spirit\" in it.\n* The Batman Trilogy is the best superhero saga of all time and its peak The Dark Knight is no doubt a masterpiece as well. Nonetheless, every time we talk about it, Heath Ledger takes all the spotlights with his life-time-role: The (unique-and-only) Joker.\n* Then there came Inception where Nolan truly stood out, having every single detail of his work done in the finest way. The multi-layered storyline despite its complexity, remains consistent and originally interesting. From visual aspect, everything was masterly handled: an impeccable cross-cutting allowed the movie to follow Nolan's nonlinear story-telling without being scattered; a wonderful cinematography work completed with incredibly imaginative visual-effects brought into life so many breathtaking scenes, some of them, I believe, will stay in the audience's mind for a long time (city bending in Paris, zero-gravity fight, in limbo, dreams collapsing...). In addition, Nolan had also a solid cast ensemble to help him deliver all of his messages.\n* Later, we had Interstellar. Though I did admire its cinematography and visual-effects, the film itself is nowhere near the level of Inception.\n\n\n\n\n SPOILERS AHEAD !!!!! For all who haven't watched this movie, you may stop the reading right here because the following paragraphs contain a ton of spoilers!\n\nIt is set in the world where there's technology that allows people to literally share dream. There is, in this world, a new kind of corporate spy - \"extractors\" who use this technology to infiltrate the target's subconscious and extract valuable information through a shared dream world. Our hero Mr Cobb (Leonardo DiCaprio), a very well-known extractor, and his partner Arthur (Joseph Gordon-Levitt) are approached by a powerful businessman - Mr Saito (Ken Watanabe) for a nearly impossible mission, something no one has ever done before : instead of stealing, he wants them to plant an idea in a person's subconscious, which is also called \"inception\". In return, Saito offers something that Cobb could never resist: a ticket to go home with his children by taking out the homicide charge against him. So Cobb and Arthur gather a team to carry out the mission: Eames (Tom Hardy) - a veteran identity forger, Yusuf - the only one chemist can make such a powerful sedative for such a complex 3-levels \"dream within a dream\", and Ariadne (Ellen Page) - a newbie but remarkably talented architect whose role is critical for the success of the mission. The target is Robert Fischer (Cillian Murphy) - son and heir of Saito's biggest competitor (Maurice Fischer, who's dying). The goal is to seed an idea into his mind which will make him abandon his father's business, and the team has to carry Saito as visitor in their mission to let him verify the result of inception. While the team go deeper and deeper into Fischer's mind, we discover gradually the dark of Cobb's past, as well as the 2 biggest why concerning our hero: Why he has became such an expert of inception and What is his desperate motivation for taking that insane mission.\n\nThe movie is not only about the inception mission but more importantly, about the struggle of finding the way in the maze of life. In Cobb's case, it's the maze of dreams built by his memories with his past wife Mal (Marion Cotillard) and his regrets. So as long as he let himself consumed by the past by blaming himself for the death of his love wife, it will keep coming back and haunt his present: the deeper the team go into dream, the more dangerous his subconscious, under the form of his ghostly wife, comes out and could anytime jeopardize the mission. Indeed, if we apprehend the movie with these 2 layers of its story, the ending scene makes perfect sense. Yes! We're now talking about that famous ending which has still remained one of the most controversial movie endings in the cinema history. Did Cobb find Mr Saito in limbo, bring he back to complete the mission then come back to his children in the real world? Or they are still stuck in limbo - the infinite dream world, and the last scene was just his big dream? But all of those question only matter in the first layer of the story: the result of inception mission. When we perceive the story in its deeper layer, as a journey for Cobb to let go of his feeling of guilt for the past and re-find the meaning of his life, this ending did fulfill its job. Cobb didn't even stay to see either if the spinning top would fall because he didn't care any more, what's important to him is that he gonna be with his kids. He did finally get rid of his haunting past and be able to move on, and that matters. And after all, dream or reality, the importance is to truly live. So from this point of view, he has solved the maze of his life.\n\n Some short lines about the cast: \n* Leo has done justice to our main character but he did not success to make a leap from his previous similar roles in Shutter Island and Blood Diamond.\n* Joseph Gordon-Levitt could have been more intense, given the fact that he had the most astounding fight scene in the movie (zero-gravity sequence).\n* There was something missing in Ken Watanabe's performance to portray the powerful man who sponsored the crazy mission. Maybe it was his English...\n* Tom Hardy was OK but forgettable because his character didn't have any memorable moment though he had a lot of screen time.\n* Ellen Page was really impressive, she did fully illustrate the cleverness and the keenness of the young brilliant architect. And personally, I did find a lot of charms in her acting.\n* Cillian Murphy has also done a great job. Much more emotionally complex than just a target of the inception mission, his character Robert Fischer, at the end, was not so different than our hero Cobb. They both were struggling to find a way out of their own maze. If for Cobb, it was the painful past with his late wife; for Fischer, it was the grand shadow and the lack of recognition of his late dad.\n* Last but not least, the one who impressed me the most was Marion. Mal was so beautiful and mysterious in a very unique haunting way, mostly with her speaking eyes! And for me, she is the most remarkable character of the movie.\n",
      "spoiler": true,
      "upVotes": 600,
      "downVotes": 85
    },
    {
      "id": "rw2299419",
      "date": "2010-08-22",
      "title": "Matrix but in dreamworld? Nah.",
      "author": "clipturnity",
      "rating": 9,
      "review": "I'd like to keep my review rather to the point.\n\nPros: 1. its theme - dream is a fascinating topic to say the least. There are a lot of unknowns in dreamworld. \n\n2. its plot - there are several sweet twists and unpredictable turns. \n\n3. its edgy drive - although you know what's coming next, still you feel jumpy about it when it does.\n\n4. its rapid storyline - the story moves fast from one scene to another, making the viewers feel like on a roller coaster ride. At times, it's hard to keep up, even after watching it several times. \n\n5. its sophistication - there is a lot of information to remember and digest. This is the very thing the modern moviegoers are after, I believe. \n\n6. its realism - okay, pun intended. The movie explains (or at least tries to) the ins and outs of what dream is about and how it functions, some of which are very familiar with and dear to us.\n\nCons: 1. its poor character development - although the acting was convincing enough there was not enough of character development. I wonder how many people really felt connected to the main character(s) after watching the movie. Yes, the movie talks about emotional struggles but it was more of an action film than anything else, if you ask me. \n\n2. too many distractions - I found that the movie had more characters than necessary. They may play certain roles in the plot but they seemed more of distractions than anything else. I wish the movie was more focused. \n\n3. a bit preachy - I noticed that the characters would explain things about dreamworld and then the exact things happen later in the movie. I'm afraid, Inception overused this trick. \n\nIn conclusion, its theme is fascinating but its delivery is not without room for improvement. \n\nI highly recommend you to go and read Somewhere carnal over 40 winks, if you dig this kind of flicks. \n\nCheers!",
      "spoiler": true,
      "upVotes": 1874,
      "downVotes": 330
    },
    {
      "id": "rw6388098",
      "date": "2020-12-22",
      "title": "Is it possible the makers understand how incredible this film is?",
      "author": "srcooper-756-646671",
      "rating": 10,
      "review": "You only get to watch this for the first time once, so choose your state of mind carefully. It is a film about movies and dreams and reality, and what sort of life it is best to find when you leave the cinema and return to whatever you left to enter. It is spectacular, and brutal, and enigmatic and disturbing. It is beautiful and absorbing. It is about one of my favourite characters ever to grace the screen. I don't see it often, in case it's not as good as I like to remember it. That is my secret, that I lock away in my safe in the basement. That somewhere there is a perfect world for us all. For some, perhaps it is in the cinema watching this.",
      "upVotes": 416,
      "downVotes": 62
    },
    {
      "id": "rw7209937",
      "date": "2021-08-09",
      "title": "Inception was only less shocking to me than the Matrix",
      "author": "mrmocun",
      "rating": 10,
      "review": "When you wake up from a good dream, you feel the reality is harsh. When you wake up after a bad dream, you will be sentimentally attached to the beauty of reality. But as long as life is good, reality and dreams don't matter.",
      "upVotes": 206,
      "downVotes": 44
    },
    {
      "id": "rw7549616",
      "date": "2021-11-15",
      "title": "Generation defining.",
      "author": "forzosky",
      "rating": 10,
      "review": "The 20th Century had Casablanca, Star Wars, the Godfather, Blade Runner, and others - this is the first of the 21st Century masterpieces. Truly in awe at how amazing this movie is, an astounding show of all aspects of films. Amazing story and cinematography accompanied with actors worthy of telling the tale. Remarkable and breathtaking.",
      "upVotes": 153,
      "downVotes": 32
    },
    {
      "id": "rw8902176",
      "date": "2023-03-02",
      "title": "Answering all the questions with one answer: I feel guilt. ⭐",
      "author": "EVON1TY",
      "rating": 10,
      "review": "When I first watch this movie, I was just shocked with it's twist. I'm not gonna mention details, because can't share any spoilers.\n\nSimply this movie makes a complex story, that makes you question so many things. \"Why he is keeping her in his dreams?\" or whatever your question is answering with some well written line. That scene is the key to the whole movie. That line between Cobb and Mal answers all your questions at once.\n\nThat's why I like this movie so much. Some movies has that potential. Making a complex story that someone could answer with only one sentence. You're waiting for that line for whole content. But most of the contents (I mean movie or TV Series) are not managing that well.\n\nBesides the greatness of the storyline this movie has a really great cast. So Acting Performances are also great. Award Winning Cinematography by Wally Pfister was too great. Original Scores by Hans Zimmer was brilliant. Visual Effects are unique. So not only the Screenplay but nearly all the technical details are great.",
      "upVotes": 88,
      "downVotes": 23
    },
    {
      "id": "rw2285156",
      "date": "2010-07-25",
      "title": "Good idea lost in the noise",
      "author": "Carl_Tait",
      "rating": 5,
      "review": "The central idea of \"Inception\" is an interesting one: technology exists to enter other people's dreams in order to steal their most private secrets or to implant new ideas. With Christopher Nolan of \"Memento\" fame as writer and director, this should have been a smart, compelling movie. Unfortunately, \"Inception\" is a bloated failure.\n\nThe root problem is that Nolan replaces the fascinating surrealism of dream worlds with lengthy outtakes from James Bond movies. For example, early in the film, when Cobb and Ariadne are sitting at a café in a dream world, Cobb tells Ariadne to stay calm. What's going to happen? Is the waiter going to bring her a glass full of wriggling eyeballs? Is she going to turn around and see her best friend from high school having sex with Abraham Lincoln? No. THINGS START EXPLODING. And that's the whole movie in a nutshell: gaudy special effects and endless fight scenes as a poor substitute for imaginative ideas.\n\nThe matryoshka-doll plot of dreams within dreams isn't nearly as hard to follow as one might imagine. This is largely because nothing of consequence happens at higher levels once our heroes have moved on to deeper levels. The higher-level supporting actors just fight off bad guys -- and overblown special effects -- until it's time to bring back their colleagues from the depths.\n\nNolan should sit back, watch a few of the best movies by Luis Bunuel and David Lynch, and try again with one-tenth the budget and ten times the imagination. (Okay, that's never gonna happen, but it's *my* dream.)",
      "spoiler": true,
      "upVotes": 517,
      "downVotes": 457
    },
    {
      "id": "rw2276780",
      "date": "2010-07-10",
      "title": "Insanely Brilliant ! Nolan has outdone himself !!",
      "author": "naman-avastol",
      "rating": 10,
      "review": "What is the most resilient parasite? An Idea! Yes, Nolan has created something with his unbelievably, incredibly and god- gifted mind which will blow the minds of the audience away. The world premiere of the movie, directed by Hollywood's most inventive dreamers, was shown in London and has already got top notch reviews worldwide and has scored maximum points! Now the question arises what the movie has that it deserve all this?\n\nDom Cobb(Di Caprio) is an extractor who is paid to invade the dreams of various business tycoons and steal their top secret ideas. Cobb robs forcefully the psyche with practiced skill, though he's increasingly haunted by the memory of his late wife, Mal (Marion Cotillard), who has a nasty habit of showing up in his subconscious and wreaking havoc on his missions. Cobb had been involved so much in his heist work that he had lost his love!\n\nBut then, as fate had decided, a wealthy business man Saito( Ken Watanabe) hands over the responsibility of dissolving the empire of his business rival Robert Fischer Jr.(Cillian Murphy). But this time his job was not to steal the idea but to plant a new one: 'Inception'\n\nThen what happens is the classic heist movie tradition. To carry out the the task, Cobb's 'brainiac' specialists team up again with him, Arthur (Joseph Gordon-Levitt), his longtime organizer; Tom Hardy (Eames), a \"forger\" who can shapeshift at will; and Yusuf (Dileep Rao), a powerful sedative supplier.\n\nThere is only one word to describe the cinematography, the set designs and the special effects, and that is Exceptional! You don't just watch the scenes happening, you feel them. The movie is a real thrill ride. The action scenes are well picturised and the music by Hans Zimmer is electronically haunting. Never, in the runtime of the movie, you will get a chance to move your eyes from the screen to any other object.\n\nLeonardo, who is still popularly known for Jack Dawson played by him in Titanic, should be relieved as his role as Dom Cobb will be remembered forever. His performance may or may not fetch him an Oscar but it will be his finest performance till date. The supporting cast too did an extraordinary work. Christopher Nolan, ah! What a man he is. His work is nothing less than a masterpiece and he deserves all the awards in the 'Best Director' category. If \"Inception\" is a metaphysical puzzle, it's also a metaphorical one: It's hard not to draw connections between Cobb's dream-weaving and Nolan's film making, intended to seduce us, mess with our heads and leave an ever-lasting impression.\n\nTo conclude, I would just say before your life ends, do yourself a favor by experiencing this exceptionally lucid classic created by Nolan!\n\nMy Rating: 10/10\n\nThanks & Regards.",
      "spoiler": true,
      "upVotes": 2182,
      "downVotes": 861
    },
    {
      "id": "rw5467732",
      "date": "2020-02-08",
      "title": "Didn't win Best Picture? WHAT?",
      "author": "wokeuplookingfordabroccoli",
      "rating": 10,
      "review": "Inception is as original as you can get with a sci-fi movie. I feel like it's kind of pointless to compare this to Blade Runner, Aliens, Terminator 2, 2001: A Space Odyssey or any other sci-fi blockbusters, for they're completely different. What Nolan crafted is genius, in my mind he is still yet to make a bad movie, it is now time to get into spoiler territory.\n\nInception is a story about dreams, how you can build anything you want, Nolan took 10 years to write the screenplay and it was definitely worth-while, this is one of the most mind-blowing, nail-biting, epic action packed science fiction movies of all time. All the performances in this film are amazing, the special effects are flawless, the acting is flawless, the story is flawless, the writing is flawless, this is one of a few pictures that just got everything right in all categories, most people saw there is no such thing as a flawless movie and I would 100% love to disagree with them there, all of the Christopher Nolan movies I have seen so far have no real flaws. Leonardo DiCaprio+Christopher Nolan= pure gold, these two should definitely collaborate more, Inception just proves that Chris is a cinematic God, from his screenplays, to his production, to his film direction, everything is perfect!\n\nYou have to imagine it to believe it. Watching it once isn't enough, watching it twice isn't enough, you have got to watch this 10 times or even more to really get the true essence of why this movie is considered to be one of the greatest of all time. It is truly film-making at it's greatest! It is one of the most re-watch-able movies a director has ever put out! It's like Dark Knight, Memento and most of his other work where immediately after you watch it you feel like watching it again.\n\nAt times it gets confusing because sometimes it feels like it's the real world when it is actually the dream world and Leonardo DiCaprio's performance, oh my god! In my opinion it is his greatest performance. And Inception SHOULD HAVE WON BEST PICTURE! Fun fact: This film got nominated for Best Screenplay and many other Oscar nominations, yet they don't nominate the man who put it all together who DIRECTED THE GOSH-DARN MASTERPIECE!\n\nI watch this film at least twice a week and to see that Watchmojo put Social Network higher than Inception on their Top 10 Movies of the Decade list p*sses me off! Yeah, it's David Fincher, I get that Watchmojo love David Fincher, but higher than Inception? NAH!\n\nIf anybody else directed this it would be an average, unoriginal and completely unimaginative piece of work. When Nolan gets his hands on something it is always going to be original, classic and everything great about movies. I'd place this on my top 5 films of the century list, most films on that list would include Nolan films because he is the best director working today and you have to accept that.\n\nMore will be added soon...",
      "spoiler": true,
      "upVotes": 66,
      "downVotes": 22
    }
  ],
  "nextPage": 2
}
```

---

### Search

IMDb Search — autocomplete/suggestion lintas-tipe (judul, orang, perusahaan).

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/search`
- **Cache TTL:** 600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Kata kunci pencarian: judul film/serial, nama aktor/kru, atau perusahaan |
| `type` | enum(all|title|name|company) | query | no | Filter jenis hasil: all=semua, title=film/serial, name=orang, company=perusahaan. Default all |
| `limit` | number | query | no | Jumlah hasil maksimum. Default 12, max 20 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/search?q=inception&type=all&limit=12" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/search?q=inception&type=all&limit=12", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/search?q=inception&type=all&limit=12",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "type": "all",
  "count": 8,
  "query": "inception",
  "results": [
    {
      "id": "tt1375666",
      "kind": "title",
      "type": "feature",
      "year": 2010,
      "image": "https://m.media-amazon.com/images/M/MV5BMjAxMzY3NjcxNF5BMl5BanBnXkFtZTcwNTI5OTM0Mw@@._V1_QL75_UX300_.jpg",
      "title": "Inception",
      "typeId": "movie",
      "subtitle": "Leonardo DiCaprio, Joseph Gordon-Levitt",
      "videoCount": 35,
      "popularityRank": 199
    },
    {
      "id": "tt1790736",
      "kind": "title",
      "type": "video",
      "year": 2010,
      "image": "https://m.media-amazon.com/images/M/MV5BNjYxOGIzZDItN2I2NC00ZjE2LTllYmEtMWMxODUwOGU5NGI1XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Inception: The Cobol Job",
      "typeId": "video",
      "popularityRank": 26328
    },
    {
      "id": "tt7321322",
      "kind": "title",
      "type": "short",
      "year": 2014,
      "image": "https://m.media-amazon.com/images/M/MV5BOTY3OGFlNTktYTJiZi00ZWMxLTk4MjQtNmJiODkxYThiNjg4XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Inception",
      "typeId": "short",
      "subtitle": "Erfan Refahatnia, Danial Hajibarat",
      "popularityRank": 118101
    },
    {
      "id": "tt5295990",
      "kind": "title",
      "type": "video",
      "year": 2010,
      "image": "https://m.media-amazon.com/images/M/MV5BZjhkNjM0ZTMtNGM5MC00ZTQ3LTk3YmYtZTkzYzdiNWE0ZTA2XkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Inception: Jump Right Into the Action",
      "typeId": "video",
      "subtitle": "Leonardo DiCaprio, Joseph Gordon-Levitt",
      "popularityRank": 57304
    },
    {
      "id": "tt8269586",
      "kind": "title",
      "type": "feature",
      "year": 2015,
      "image": "https://m.media-amazon.com/images/M/MV5BMWFhNWE4ZGEtYjkyNC00ODE0LTk4ZjQtNDU4NzU4NzEyNTZlXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "Bikini Inception",
      "typeId": "movie",
      "subtitle": "Paizley Bishop, Byamba",
      "popularityRank": 123011
    },
    {
      "id": "tt6793710",
      "kind": "title",
      "type": "feature",
      "year": 2019,
      "image": "https://m.media-amazon.com/images/M/MV5BZTc4MDliNjAtYmU4YS00NmQzLWEwNjktYTQ2MGFjNDc5MDhlXkEyXkFqcGc@._V1_QL75_UX300_.jpg",
      "title": "The Crack: Inception",
      "typeId": "movie",
      "subtitle": "Carlos Santos, Miguel Ángel Muñoz",
      "popularityRank": 116989
    },
    {
      "id": "tt12960252",
      "kind": "title",
      "type": "feature",
      "year": 2010,
      "title": "Inception Premiere",
      "typeId": "movie",
      "subtitle": "Tera Hendrickson, Johnny Marr",
      "popularityRank": 567172
    },
    {
      "id": "tt1686778",
      "kind": "title",
      "type": "TV movie",
      "year": 2010,
      "title": "Inception: 4Movie Premiere Special",
      "typeId": "tvMovie",
      "subtitle": "Rick Edwards",
      "popularityRank": 421889
    }
  ]
}
```

---

### Title

IMDb Title Detail — info lengkap satu film / serial / episode by IMDb ID.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/movie:imdb/title/:id`
- **Cache TTL:** 1800s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `id` | string | path | yes | IMDb title ID (diawali `tt`). Boleh tempel URL IMDb penuh — ID di-ekstrak otomatis |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/movie:imdb/title/:id" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/movie:imdb/title/:id", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/movie:imdb/title/:id",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "id": "tt1375666",
  "url": "https://www.imdb.com/title/tt1375666/",
  "plot": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
  "type": "Movie",
  "year": 2010,
  "stars": [
    {
      "id": "nm0000138",
      "name": "Leonardo DiCaprio"
    },
    {
      "id": "nm0330687",
      "name": "Joseph Gordon-Levitt"
    },
    {
      "id": "nm0680983",
      "name": "Elliot Page"
    },
    {
      "id": "nm0913822",
      "name": "Ken Watanabe"
    }
  ],
  "title": "Inception",
  "budget": {
    "amount": 160000000,
    "currency": "USD"
  },
  "genres": [
    "Adventure",
    "Sci-Fi",
    "Thriller"
  ],
  "poster": "https://m.media-amazon.com/images/M/MV5BMjAxMzY3NjcxNF5BMl5BanBnXkFtZTcwNTI5OTM0Mw@@._V1_QL75_UX800_.jpg",
  "rating": 8.8,
  "typeId": "movie",
  "tagline": "Your mind is the scene of the crime.",
  "writers": [
    {
      "id": "nm0634240",
      "name": "Christopher Nolan"
    }
  ],
  "isSeries": false,
  "keywords": [
    "dream",
    "ambiguous ending",
    "subconscious",
    "surprise ending",
    "mindbender",
    "psycho thriller",
    "architecture",
    "psychological manipulation",
    "fantasy becomes reality",
    "deception",
    "suicide",
    "kidnapping"
  ],
  "countries": [
    "United Kingdom",
    "United States"
  ],
  "directors": [
    {
      "id": "nm0634240",
      "name": "Christopher Nolan"
    }
  ],
  "isEpisode": false,
  "languages": [
    "English",
    "Japanese",
    "French"
  ],
  "voteCount": 2823283,
  "alsoKnownAs": [
    {
      "title": "Inception",
      "country": "United Arab Emirates"
    },
    {
      "title": "Inception",
      "country": "Australia"
    },
    {
      "title": "Inception",
      "country": "Belgium"
    },
    {
      "title": "Inception",
      "country": "Canada"
    },
    {
      "title": "Inception",
      "country": "Germany"
    },
    {
      "title": "Inception",
      "country": "Denmark"
    },
    {
      "title": "Inception",
      "country": "France"
    },
    {
      "title": "Inception",
      "country": "United Kingdom"
    }
  ],
  "certificate": "PG-13",
  "releaseDate": "2010-07-16",
  "keywordCount": 457,
  "originalTitle": "Inception",
  "grossWorldwide": {
    "amount": 839796627,
    "currency": "USD"
  },
  "popularityRank": 87,
  "posterOriginal": "https://m.media-amazon.com/images/M/MV5BMjAxMzY3NjcxNF5BMl5BanBnXkFtZTcwNTI5OTM0Mw@@._V1_.jpg",
  "runtimeMinutes": 148,
  "productionStatus": "Released"
}
```

---


_Generated: 2026-08-02T14:26:18.207Z_