# IMDb Autocomplete — Zapi reference

> IMDb title and name autocomplete — returns records with ids, years, posters and cast, not just query strings.

**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/autocomplete/imdb-autocomplete
- Endpoint catalog: https://zpi.web.id/category/autocomplete
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## IMDb Autocomplete

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

IMDb title and name autocomplete — returns records with ids, years, posters and cast, not just query strings.

**Tags:** imdb, movie, tv, autocomplete

### Autocomplete

Titles and names matching a seed.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Title or name to complete |
| `count` | number | query | no | Cap the list. Default: everything the upstream returns |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/autocomplete:imdb-autocomplete/autocomplete?q=kucing&count=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/autocomplete:imdb-autocomplete/autocomplete?q=kucing&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/autocomplete:imdb-autocomplete/autocomplete?q=kucing&count=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 8,
  "items": [
    {
      "id": "tt43408259",
      "url": "https://www.imdb.com/title/tt43408259/",
      "cast": "Keiko Ananta, La Rheina Isabelle Bishop",
      "rank": 248370,
      "text": "Kucing Hitam",
      "type": "movie",
      "year": 2026
    },
    {
      "id": "tt7144986",
      "url": "https://www.imdb.com/title/tt7144986/",
      "cast": "Masayu Anastasia, Adi Nugroho",
      "rank": 940051,
      "text": "12:06 Rumah Kucing",
      "type": "movie",
      "year": 2017,
      "image": "https://m.media-amazon.com/images/M/MV5BNGEwY2NkOTgtMjEyMi00ZTQ2LWJkNWQtNjk5NTUxNjJjY2I0XkEyXkFqcGc@._V1_.jpg"
    },
    {
      "id": "tt9277738",
      "url": "https://www.imdb.com/title/tt9277738/",
      "cast": "Aline Adita, Natalius Chendana",
      "rank": 1357627,
      "text": "Rawa Kucing",
      "type": "short",
      "year": 2013,
      "image": "https://m.media-amazon.com/images/M/MV5BNGI4ZTMwNjUtN2ZjMC00M2Q4LWJiMzEtN2Q0ZTcxNDJmMGJhXkEyXkFqcGc@._V1_.jpg"
    },
    {
      "id": "tt13469414",
      "url": "https://www.imdb.com/title/tt13469414/",
      "cast": "Harith Haziq, Rayyan Dino",
      "rank": 1619194,
      "text": "Kucing Air",
      "type": "short",
      "year": 2019,
      "image": "https://m.media-amazon.com/images/M/MV5BYWFlNjJhZTUtMjRiMC00N2ZkLWIwMmUtYzY2ZTliZDFiYTE5XkEyXkFqcGc@._V1_.jpg"
    },
    {
      "id": "tt9699148",
      "url": "https://www.imdb.com/title/tt9699148/",
      "cast": "Judith Cabral, Sarah Natochenny",
      "rank": 85775,
      "text": "44 Cats",
      "type": "tvSeries",
      "year": 2018,
      "image": "https://m.media-amazon.com/images/M/MV5BOTM0ODFhNjktMzZkYS00ZmNiLTlmYzYtM2UxMzQwOGU2YWYwXkEyXkFqcGc@._V1_.jpg"
    },
    {
      "id": "tt32378496",
      "url": "https://www.imdb.com/title/tt32378496/",
      "cast": "Ana Tasya Lalita, Muhammad Redho",
      "rank": 2262933,
      "text": "Kucing Zel Zel",
      "type": "tvMiniSeries",
      "year": 2021,
      "image": "https://m.media-amazon.com/images/M/MV5BY2NkMTYyMDgtNTJkZC00MjUxLTk3OGQtNGYxOWI1ZjliMzE3XkEyXkFqcGc@._V1_.jpg"
    },
    {
      "id": "tt35670577",
      "url": "https://www.imdb.com/title/tt35670577/",
      "cast": "Kate Mara, Rooney Mara",
      "rank": 1699,
      "text": "Bucking Fastard",
      "type": "movie",
      "year": 2026,
      "image": "https://m.media-amazon.com/images/M/MV5BZjcxMzc5ZjctODg1NS00N2JkLTg5NDgtMDgwNmUzZTg5OGQxXkEyXkFqcGc@._V1_.jpg"
    },
    {
      "id": "tt10681410",
      "url": "https://www.imdb.com/title/tt10681410/",
      "rank": 2655882,
      "text": "Kucing Menangis",
      "type": "tvSeries",
      "year": 2018
    }
  ],
  "query": "kucing",
  "provider": "imdb"
}
```

---

### Expand

Enumerate titles — the seed with every letter appended, deduplicated.

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

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Seed to expand |
| `modifiers` | enum(all|alphabet|questions|prepositions|digits) | query | no | Which modifier sets to append. Default all |
| `lang` | enum(id|en) | query | no | Language for the question and preposition sets. Default en |
| `count` | number | query | no | Cap the returned list. Default: every unique result found |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/autocomplete:imdb-autocomplete/expand?q=kucing&modifiers=all&lang=en&count=200" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/autocomplete:imdb-autocomplete/expand?q=kucing&modifiers=all&lang=en&count=200", {
  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/autocomplete:imdb-autocomplete/expand?q=kucing&modifiers=all&lang=en&count=200",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "seed": "kucing",
  "count": 82,
  "items": [
    {
      "via": "seed",
      "text": "Kucing Hitam"
    },
    {
      "via": "seed",
      "text": "12:06 Rumah Kucing"
    },
    {
      "via": "seed",
      "text": "Rawa Kucing"
    },
    {
      "via": "seed",
      "text": "Kucing Air"
    },
    {
      "via": "seed",
      "text": "44 Cats"
    },
    {
      "via": "seed",
      "text": "Kucing Zel Zel"
    },
    {
      "via": "seed",
      "text": "Bucking Fastard"
    },
    {
      "via": "seed",
      "text": "Kucing Menangis"
    }
  ],
  "locale": "en",
  "provider": "imdb",
  "modifiers": "alphabet",
  "truncated": false,
  "variantsTried": 27,
  "variantsFailed": 0
}
```

---


_Generated: 2026-08-02T14:23:52.518Z_