☠

DEN DEN MUSHI API

⚓ One Piece Knowledge · REST API · v1 ⚓

Access the Grand Line Archives programmatically. Characters, chapters, episodes, bounties, Devil Fruits and more — all from the One Piece dataset.

Free · 3 req/day API Key Required JSON v1

BASE URL https://dendenmushi.space/v1

⚡ Rate Limits

Rate limits are applied per IP address. Response headers tell you your current usage.

Tier	Requests/day	Auth	Cost
🟢 Free	3	API Key	Free forever
🔵 Basic (coming soon)	1,000	API Key	Coming soon
🟡 Pro (coming soon)	10,000	API Key	Coming soon

Limits reset daily at midnight UTC. Every response includes X-RateLimit-* headers.

⚓ GET FREE API KEY 🗝 DASHBOARD

Response Headers

X-RateLimit-Limit	Your daily request limit
X-RateLimit-Used	Requests used today
X-RateLimit-Remaining	Requests left today
X-RateLimit-Reset	When your limit resets (UTC)

Endpoints

👤 Characters

GET /v1/character/{name} Full character page

Returns the full page for a character including all sections. Name is case-insensitive and accepts spaces or underscores.

Param	Type	Description
name	path	Character name e.g. `Nami`, `roronoa_zoro`
fieldsoptional	query	Comma-separated fields to return e.g. `?fields=title,sections`

# Request
GET /v1/character/Nami

# Response
{
  "source_id": "Nami",
  "title":     "Nami",
  "type":      "character",
  "page_id":   1584,
  "sections": {
    "Bounty":     "366,000,000 berries",
    "Appearance": "Nami is a slim young woman...",
    "Personality": "..."
  },
  "content": "66,000,000 16,000,000\nBounty: 366,000,000 berries\n..."
}

GET /v1/character/{name}/bounty Bounty only

Returns only the bounty information for a character.

# Request
GET /v1/character/Roronoa_Zoro/bounty

# Response
{
  "character": "Roronoa_Zoro",
  "bounty":    "1,111,000,000 berries",
  "all_bounties_raw": null
}

GET /v1/character/{name}/section/{section} Single section

Returns a specific section of a character page. Section names are case-insensitive.

GET /v1/character/Luffy/section/abilities-and-powers
GET /v1/character/Shanks/section/bounty

📖 Chapters & Episodes

GET /v1/chapter/{number} Chapter summary

Returns the summary page for a chapter. Covers chapters 1–1185.

GET /v1/chapter/1000

GET /v1/episode/{number} Episode summary

Returns the summary page for an episode. Covers episodes 1–1031.

GET /v1/episode/1015

🔍 Search

GET /v1/search Search all pages

Search pages by keyword across title and source_id. Optionally filter by type.

Param	Type	Description
q	query	Search keyword (min 2 chars)
typeoptional	query	`character`, `chapter`, `episode`, `arc`
limitoptional	query	Max results, default 10, max 20

GET /v1/search?q=zoro&type=character
GET /v1/search?q=marineford&limit=5

🎲 Random

GET /v1/random Random page

Returns a random page. Optionally filter by type.

GET /v1/random
GET /v1/random?type=character

GET /v1/types Available types & counts

GET /v1/types

# Response
{
  "types": {
    "character": ...,
    "chapter":   ...,
    "episode":   ...,
    "group":     ...
  },
  "total": ...
}

Code Examples

Replace YOUR_API_KEY with your key from the dashboard.

# Get character info
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.dendenmushi.space/v1/character/Roronoa_Zoro

# Get bounty only
curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.dendenmushi.space/v1/character/Nami/bounty

# Search
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.dendenmushi.space/v1/search?q=zoro&type=character"

# Random character
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.dendenmushi.space/v1/random?type=character"

# Get character info
$headers = @{"X-API-Key" = "YOUR_API_KEY"}

Invoke-WebRequest -Uri "https://api.dendenmushi.space/v1/character/Roronoa_Zoro" `
  -Headers $headers | Select-Object -ExpandProperty Content

# Get bounty only
Invoke-WebRequest -Uri "https://api.dendenmushi.space/v1/character/Nami/bounty" `
  -Headers $headers | Select-Object -ExpandProperty Content

# Search
Invoke-WebRequest -Uri "https://api.dendenmushi.space/v1/search?q=zoro&type=character" `
  -Headers $headers | Select-Object -ExpandProperty Content

# pip install requests
import requests

API   = "https://api.dendenmushi.space/v1"
KEY   = "YOUR_API_KEY"
HDRS  = {"X-API-Key": KEY}

# Get character
r = requests.get(f"{API}/character/Roronoa_Zoro", headers=HDRS)
print(r.json()["title"])
print("Remaining:", r.headers.get("X-RateLimit-Remaining"))

# Get bounty
r = requests.get(f"{API}/character/Nami/bounty", headers=HDRS)
print(r.json()["bounty"])

# Search
r = requests.get(f"{API}/search", headers=HDRS, params={"q": "zoro", "type": "character"})
for result in r.json()["results"]:
    print(result["title"])

// Browser or Node.js
const API  = "https://api.dendenmushi.space/v1";
const KEY  = "YOUR_API_KEY";
const hdrs = { "X-API-Key": KEY };

// Get character
const r = await fetch(`${API}/character/Roronoa_Zoro`, { headers: hdrs });
const data = await r.json();
console.log(data.title);
console.log("Remaining:", r.headers.get("X-RateLimit-Remaining"));

// Get bounty
const bounty = await fetch(`${API}/character/Nami/bounty`, { headers: hdrs });
console.log((await bounty.json()).bounty);

// Search
const search = await fetch(`${API}/search?q=zoro&type=character`, { headers: hdrs });
const results = (await search.json()).results;
results.forEach(x => console.log(x.title));


$api = "https://api.dendenmushi.space/v1";
$key = "YOUR_API_KEY";

function ddm_get($url, $key) {
    $ctx = stream_context_create(["http" => [
        "header" => "X-API-Key: $key\r\n"
    ]]);
    return json_decode(file_get_contents($url, false, $ctx), true);
}

// Get character
$data = ddm_get("$api/character/Roronoa_Zoro", $key);
echo $data["title"] . "\n";

// Get bounty
$data = ddm_get("$api/character/Nami/bounty", $key);
echo $data["bounty"] . "\n";

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET",
        "https://api.dendenmushi.space/v1/character/Roronoa_Zoro", nil)
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, _ := client.Do(req)
    defer resp.Body.Close()

    var data map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&data)
    fmt.Println(data["title"])
    fmt.Println("Remaining:", resp.Header.Get("X-RateLimit-Remaining"))
}

Errors

404 — not_found

The requested character, chapter, or episode does not exist in the dataset.

429 — rate_limit_exceeded

You've hit the daily limit. Check X-RateLimit-Reset for when it resets.

400 — invalid_query

Search query too short or missing required parameters.