# Dragon Ball API
> The Dragon Ball universe as an API — the characters and planets of Akira Toriyama's saga. Look up a character by name or id (e.g. Goku → Saiyan, Z Fighter, ki 60,000,000, origin planet Vegeta, with all six of his transformations and their power levels) or search and filter the roster by race (Saiyan, Namekian, Frieza Race, Android, Majin, God, Angel and more), affiliation and gender. Browse the planets of the series with their descriptions and destroyed status. Each character carries ki and max ki, race, affiliation, a portrait and the full list of transformations. Backed by the open dragonball-api.com dataset. Ideal for fan sites, trivia and quiz games, power-level calculators, Discord bots and any Dragon Ball app.

## 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/dragonball-api/..."
```

## Pricing
- **Free** (Free) — 10,200 calls/Mo, 2 req/s
- **Starter** ($3/Mo) — 148,000 calls/Mo, 8 req/s
- **Pro** ($10/Mo) — 690,000 calls/Mo, 20 req/s
- **Mega** ($32/Mo) — 2,830,000 calls/Mo, 50 req/s

## Endpoints

### Dragon Ball

#### `GET /v1/character` — A character by id or search/filter

**Parameters:**
- `id` (query, optional, string) — Character id, e.g. 1 (Goku) — returns transformations Example: `1`
- `name` (query, optional, string) — Name search, e.g. Goku
- `race` (query, optional, string) — Race, e.g. Saiyan, Namekian, Frieza Race, Android
- `affiliation` (query, optional, string) — Affiliation, e.g. Z Fighter
- `gender` (query, optional, string) — Male | Female | Unknown
- `page` (query, optional, string) — Page number (default 1) Example: `1`
- `limit` (query, optional, string) — Page size (1-100, default 10) Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/dragonball-api/v1/character?id=1&page=1&limit=10"
```

**Response:**
```json
{
    "data": {
        "character": {
            "id": 1,
            "ki": "60.000.000",
            "name": "Goku",
            "race": "Saiyan",
            "image": "https://dragonball-api.com/characters/goku_normal.webp",
            "gender": "Male",
            "max_ki": "90 Septillion",
            "affiliation": "Z Fighter",
            "description": "El protagonista de la serie, conocido por su gran poder y personalidad amigable. Originalmente enviado a la Tierra como un infante volador con la misión de conquistarla. Sin embargo, el caer por un barranco le proporcionó un brutal golpe que si bien casi lo mata, este alteró su memoria y anuló todos los instintos violentos de su especie, lo que lo hizo crecer con un corazón puro y bondadoso, pero conservando todos los poderes de su raza. No obstante, en la nueva continuidad de Dragon Ball se establece que él fue enviado por sus padres a la Tierra con el objetivo de sobrevivir a toda costa a la destrucción de su planeta por parte de Freeza. Más tarde, Kakarot, ahora conocido como Son Goku, se convertiría en el príncipe consorte del monte Fry-pan y líder de los Guerreros Z, así como el mayor defensor de la Tierra y del Universo 7, logrando mantenerlos a salvo de la destrucción en innumerables ocasiones, a pesar de no considerarse a sí mismo como un héroe o salvador.",
            "origin_planet": "Vegeta",
            "transformations": [
                {
                    "ki": "3 Billion",
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/planet` — A planet by id, or the list

**Parameters:**
- `id` (query, optional, string) — Planet id for detail
- `name` (query, optional, string) — Name search
- `page` (query, optional, string) — Page number Example: `1`
- `limit` (query, optional, string) — Page size (1-100, default 10) Example: `10`

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

**Response:**
```json
{
    "data": {
        "page": 1,
        "count": 10,
        "total": 20,
        "planets": [
            {
                "id": 1,
                "name": "Namek",
                "image": "https://dragonball-api.com/planetas/Namek_U7.webp",
                "description": "Planeta natal de los Namekianos. Escenario de importantes batallas y la obtención de las Dragon Balls de Namek.",
                "is_destroyed": true
            },
            {
                "id": 2,
                "name": "Tierra",
                "image": "https://dragonball-api.com/planetas/Tierra_Dragon_Ball_Z.webp",
                "description": "La Tierra también llamado Mundo del Dragón (Dragon World), es el planeta principal donde se desarrolla la serie de Dragon Ball. Se encuentra en el Sistema Solar de la Vía Láctea de las Galaxias del Norte del Universo 7, lugar que supervisa el Kaio del Norte, y tiene su equivalente en el Universo 6. El hogar de los terrícolas y los Guerreros Z. Ha sido atacado en varias ocasiones por enemigos poderosos.",
                "is_destroyed": false
            },
            {
                "id": 3,
                "name": "Vegeta",
                "image": "https://dragonball-api.com/planetas/Planeta_Vegeta_en_Dragon_Ball_Super_Broly.webp",
                "description": "El planeta Vegeta, conocido como planeta Plant antes del fin de la Guerra Saiyan-tsufruiana en el año 730, es un planeta rocoso ficticio de la serie de manga y anime Dragon Ba
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Races, affiliations & usage notes

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

**Response:**
```json
{
    "data": {
        "note": "The Dragon Ball universe. /v1/character = a character by id or search/filter (name, race, affiliation, gender) — with ki, max ki, origin planet and transformations (e.g. name=Goku → Saiyan, Z Fighter, 6 transformations); /v1/planet = a planet by id or the list. Add page & limit to paginate.",
        "races": [
            "Saiyan",
            "Namekian",
            "Human",
            "Majin",
            "Frieza Race",
            "Android",
            "Jiren Race",
            "God",
            "Angel",
            "Evil",
            "Nucleico",
            "Unknown"
        ],
        "source": "dragonball-api.com",
        "endpoints": [
            "/v1/character",
            "/v1/planet",
            "/v1/meta"
        ],
        "affiliations": [
            "Z Fighter",
            "Red Ribbon Army",
            "Namekian Warrior",
            "Freelancer",
            "Army of Frieza",
            "Pride Troopers",
            "Assistant of Vermouth",
            "Villain",
            "Other"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:28.545Z",
        "request_id": "d654b394-79dc-4488-b028-7eb08bdd276c"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


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