# Disney API
> Search and browse Disney characters — with their films, TV shows, short films, video games, park attractions, allies, enemies and artwork. Backed by the Disney character database. Great for fan apps, trivia, chatbots, recommendation and entertainment projects.

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

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

## Pricing
- **Free** (Free) — 12,000 calls/Mo, 2 req/s
- **Basic** ($6/Mo) — 120,000 calls/Mo, 8 req/s
- **Pro** ($18/Mo) — 600,000 calls/Mo, 25 req/s
- **Mega** ($49/Mo) — 2,500,000 calls/Mo, 80 req/s

## Endpoints

### Disney

#### `GET /v1/character` — Character by id

**Parameters:**
- `id` (query, required, string) — Numeric character id Example: `6`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/disney-api/v1/character?id=6"
```

**Response:**
```json
{
    "data": {
        "id": 6,
        "url": "https://api.disneyapi.dev/characters/6",
        "name": "'Olu Mel",
        "films": [],
        "image": "https://static.wikia.nocookie.net/disney/images/6/61/Olu_main.png",
        "allies": [],
        "enemies": [],
        "tv_shows": [],
        "source_url": null,
        "short_films": [],
        "video_games": [
            "Disney Tsum Tsum (game)"
        ],
        "park_attractions": [
            "Friendtastic!"
        ]
    },
    "meta": {
        "timestamp": "2026-05-30T05:56:34.603Z",
        "request_id": "59b0ad45-3aff-48c4-b3ed-6ed94bcb3ac4"
    },
    "status": "ok",
    "message": "Character retrieved",
    "success": true
}
```

#### `GET /v1/characters` — Browse characters

**Parameters:**
- `limit` (query, optional, string) — Max 1-50 Example: `20`
- `page` (query, optional, string) — Page number Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/disney-api/v1/characters?limit=20&page=1"
```

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 20,
        "results": [
            {
                "id": 112,
                "url": "https://api.disneyapi.dev/characters/112",
                "name": "Achilles",
                "films": [
                    "Hercules (film)"
                ],
                "image": "https://static.wikia.nocookie.net/disney/images/6/67/HATS_Achilles.png",
                "allies": [],
                "enemies": [],
                "tv_shows": [
                    "Hercules (TV series)"
                ],
                "source_url": null,
                "short_films": [],
                "video_games": [
                    "Kingdom Hearts III"
                ],
                "park_attractions": []
            },
            {
                "id": 18,
                "url": "https://api.disneyapi.dev/characters/18",
                "name": "Abigail the Cow",
                "films": [
                    "The Fox and the Hound",
                    "The Fox and the Hound 2"
                ],
                "image": "https://static.wikia.nocookie.net/disney/images/0/05/Fox-disneyscreencaps_com-901.jpg",
                "allies": [],
                "enemies": [],
                "tv_shows": [],
                "source_url": null,
                "short_films": [],
                "video_games": [],
                "park_attractions": []
            },
            {
                "id": 16,
                "url": "https://
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search characters

**Parameters:**
- `name` (query, required, string) — Character name Example: `Mickey Mouse`
- `limit` (query, optional, string) — Max 1-50 Example: `15`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/disney-api/v1/search?name=Mickey+Mouse&limit=15"
```

**Response:**
```json
{
    "data": {
        "count": 2,
        "query": "Mickey Mouse",
        "results": [
            {
                "id": 3942,
                "url": "https://api.disneyapi.dev/characters/3942",
                "name": "Lion (Mickey Mouse Works)",
                "films": [],
                "image": "https://static.wikia.nocookie.net/disney/images/b/bf/Char_79257.jpg",
                "allies": [],
                "enemies": [],
                "tv_shows": [
                    "Mickey Mouse Works"
                ],
                "source_url": null,
                "short_films": [],
                "video_games": [],
                "park_attractions": []
            },
            {
                "id": 4703,
                "url": "https://api.disneyapi.dev/characters/4703",
                "name": "Mickey Mouse",
                "films": [
                    "Fantasia",
                    "Fun and Fancy Free",
                    "Disney's Sing-Along Songs: The Twelve Days of Christmas",
                    "Mickey's Once Upon a Christmas",
                    "Fantasia 2000",
                    "Mickey's Magical Christmas: Snowed in at the House of Mouse",
                    "Mickey's House of Villains",
                    "Mickey, Donald, Goofy: The Three Musketeers",
                    "Mickey's Twice Upon a Christmas",
                    "Saving Mr. Banks",
                    "Mickey: The Story of a Mouse"
                ],
                "image": 
…(truncated, see openapi.json for full schema)
```


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