# MangaDex API
> MangaDex as an API — the largest community manga library, returned as clean JSON, no key. Search manga by title; open a manga for its full detail (titles and alternates, description, status, year, demographic, content rating, genre and theme tags, authors, artists and cover art); pull a manga's chapter feed in any translated language; get a chapter's detail; and fetch the ready-to-render page-image URLs for a chapter — the reader endpoint, in full and data-saver quality. Look up an author and list every genre and theme tag. Live data straight from MangaDex. Distinct from anime/manga metadata APIs: this is the actual reading platform — real chapters and page images across thousands of scanlations — ideal for manga readers, trackers, discovery and library apps. 7 data endpoints. Authenticated with an x-oanor-key; fair-use rate limits per plan.

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

## Pricing
- **Free** (Free) — 3,000 calls/Mo, 5 req/s
- **Starter** ($7/Mo) — 50,000 calls/Mo, 15 req/s
- **Pro** ($29/Mo) — 280,000 calls/Mo, 30 req/s
- **Mega** ($95/Mo) — 1,300,000 calls/Mo, 80 req/s

## Endpoints

### Manga

#### `GET /v1/manga` — Manga detail

**Parameters:**
- `id` (query, required, string) — Manga id (uuid) Example: `801513ba-a712-498c-8f57-cae55b38cc92`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mangadex-api/v1/manga?id=801513ba-a712-498c-8f57-cae55b38cc92"
```

**Response:**
```json
{
    "data": {
        "manga": {
            "id": "801513ba-a712-498c-8f57-cae55b38cc92",
            "url": "https://mangadex.org/title/801513ba-a712-498c-8f57-cae55b38cc92",
            "tags": [
                {
                    "id": "0a39b5a1-b235-4886-a747-1d05d216532d",
                    "name": "Award Winning",
                    "group": "format"
                },
                {
                    "id": "36fd93ea-e8b8-445e-b836-358f02b3d33d",
                    "name": "Monsters",
                    "group": "theme"
                },
                {
                    "id": "391b0423-d847-456f-aff0-8b0cfc03066b",
                    "name": "Action",
                    "group": "genre"
                },
                {
                    "id": "39730448-9a5f-48a2-85b0-a70db87b1233",
                    "name": "Demons",
                    "group": "theme"
                },
                {
                    "id": "3b60b75c-a2d7-4860-ab56-05f391bb889c",
                    "name": "Psychological",
                    "group": "genre"
                },
                {
                    "id": "87cc87cd-a395-47af-b27a-93258283bbc6",
                    "name": "Adventure",
                    "group": "genre"
                },
                {
                    "id": "97893a4c-12af-4dac-b6be-0dffb353568e",
                    "name": "Sexual Violence",
                    "group": "content"
                },
                {
    
…(truncated, see openapi.json for full schema)
```

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

**Parameters:**
- `title` (query, required, string) — Manga title to search Example: `berserk`
- `limit` (query, optional, string) — Max results (1–50) Example: `20`
- `status` (query, optional, string) — ongoing, completed, hiatus, cancelled
- `content_rating` (query, optional, string) — CSV: safe,suggestive,erotica Example: `safe,suggestive`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mangadex-api/v1/search?title=berserk&limit=20&content_rating=safe%2Csuggestive"
```

**Response:**
```json
{
    "data": {
        "count": 18,
        "manga": [
            {
                "id": "b00acc54-2bf1-440e-8f33-da87227d82d6",
                "url": "https://mangadex.org/title/b00acc54-2bf1-440e-8f33-da87227d82d6",
                "tags": [
                    {
                        "id": "391b0423-d847-456f-aff0-8b0cfc03066b",
                        "name": "Action",
                        "group": "genre"
                    },
                    {
                        "id": "3e2b8dae-350e-4ab8-a8ce-016e844b9f0d",
                        "name": "Long Strip",
                        "group": "format"
                    },
                    {
                        "id": "4d32cc48-9f00-4cca-9b5a-a839f0764984",
                        "name": "Comedy",
                        "group": "genre"
                    },
                    {
                        "id": "87cc87cd-a395-47af-b27a-93258283bbc6",
                        "name": "Adventure",
                        "group": "genre"
                    },
                    {
                        "id": "8c86611e-fab7-4986-9dec-d1a2f44acdd5",
                        "name": "Virtual Reality",
                        "group": "theme"
                    },
                    {
                        "id": "9438db5a-7e2a-4ac0-b39e-e0d95a34b8a8",
                        "name": "Video Games",
                        "group": "theme"
                    },
                    {
                    
…(truncated, see openapi.json for full schema)
```

### Chapters

#### `GET /v1/chapter` — Chapter detail

**Parameters:**
- `id` (query, required, string) — Chapter id (uuid) Example: `6310f6a1-17ee-4890-b837-2ec1b372905b`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mangadex-api/v1/chapter?id=6310f6a1-17ee-4890-b837-2ec1b372905b"
```

**Response:**
```json
{
    "data": {
        "chapter": {
            "id": "6310f6a1-17ee-4890-b837-2ec1b372905b",
            "url": "https://mangadex.org/chapter/6310f6a1-17ee-4890-b837-2ec1b372905b",
            "pages": 94,
            "title": "The Black Swordsman",
            "volume": "1",
            "chapter": "0.01",
            "language": "en",
            "manga_id": "801513ba-a712-498c-8f57-cae55b38cc92",
            "publish_at": "2018-01-31T07:07:06+00:00",
            "readable_at": "2018-01-31T07:07:06+00:00",
            "external_url": null,
            "scanlation_group": "Band of the Hawks"
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:46:53.697Z",
        "request_id": "dc4ee263-2cc3-4ca7-88b4-1e4b6834b1e5"
    },
    "status": "ok",
    "message": "Chapter retrieved successfully",
    "success": true
}
```

#### `GET /v1/chapter/pages` — Chapter page-image URLs (reader)

**Parameters:**
- `id` (query, required, string) — Chapter id (uuid) Example: `6310f6a1-17ee-4890-b837-2ec1b372905b`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mangadex-api/v1/chapter/pages?id=6310f6a1-17ee-4890-b837-2ec1b372905b"
```

**Response:**
```json
{
    "data": {
        "pages": [
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x1-de250240139cdbe166efb2251cb9b6d02029ae72242a953065974a12a0d86581.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x2-6cce6ed21b74b372dc3a16d9576ec7873080116ae5bcb30de8ac83684d633f3e.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x3-49c482dc071eff75b1b5d6c28f8572b23663bad8c7ed65f3940766ea8cfed290.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x4-b12f45772105f625d6f87d991cfa5f096be7378fecdcc0cf88e791a860e892f8.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x5-0b2f3a6ce26aaf764adcd09a2a65f3861672cb27ae438e80e4e6d1f5c2c29005.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x6-a8eb6f3378a1fb51b6bc7cbede9fe62b975141e4941f61a7b76dfef7d5c5268e.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x7-d677e0dccd5d3d12e0dd0e05cc7ab59cc5819a2890c664d2e699e7a58bb8d507.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x8-3ac1fb58b167877ee772d563e4cf84cf901cc96c5ee51cb6d52d1568e724609a.jpg",
            "https://cmdxd98sb0x3yprd.mangadex.network/data/7dd9b16a7f83881121980b3bf685d5ff/x9-9a98a0d418986d73701fff4c34dcda5e3
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/manga/chapters` — A manga's chapter feed

**Parameters:**
- `id` (query, required, string) — Manga id (uuid) Example: `801513ba-a712-498c-8f57-cae55b38cc92`
- `lang` (query, optional, string) — Translated language Example: `en`
- `order` (query, optional, string) — asc or desc Example: `asc`
- `limit` (query, optional, string) — Max results (1–100) Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mangadex-api/v1/manga/chapters?id=801513ba-a712-498c-8f57-cae55b38cc92&lang=en&order=asc&limit=30"
```

**Response:**
```json
{
    "data": {
        "count": 30,
        "total": 419,
        "chapters": [
            {
                "id": "6310f6a1-17ee-4890-b837-2ec1b372905b",
                "url": "https://mangadex.org/chapter/6310f6a1-17ee-4890-b837-2ec1b372905b",
                "pages": 94,
                "title": "The Black Swordsman",
                "volume": "1",
                "chapter": "0.01",
                "language": "en",
                "manga_id": "801513ba-a712-498c-8f57-cae55b38cc92",
                "publish_at": "2018-01-31T07:07:06+00:00",
                "readable_at": "2018-01-31T07:07:06+00:00",
                "external_url": null,
                "scanlation_group": "Band of the Hawks"
            },
            {
                "id": "da63389a-3d60-4634-8652-47a52e35eacc",
                "url": "https://mangadex.org/chapter/da63389a-3d60-4634-8652-47a52e35eacc",
                "pages": 69,
                "title": "The Brand",
                "volume": "1",
                "chapter": "0.02",
                "language": "en",
                "manga_id": "801513ba-a712-498c-8f57-cae55b38cc92",
                "publish_at": "2018-01-31T07:13:08+00:00",
                "readable_at": "2018-01-31T07:13:08+00:00",
                "external_url": null,
                "scanlation_group": "Band of the Hawks"
            },
            {
                "id": "0ef160be-d552-471e-a841-a027b3410430",
                "url": "https://mangadex.org/chapter/0ef160be-d552-471e
…(truncated, see openapi.json for full schema)
```

### Authors

#### `GET /v1/author` — Author detail

**Parameters:**
- `id` (query, required, string) — Author id (uuid) Example: `c705fb4e-5a7c-4dbc-b2e7-f593c988171d`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/mangadex-api/v1/author?id=c705fb4e-5a7c-4dbc-b2e7-f593c988171d"
```

**Response:**
```json
{
    "data": {
        "author": {
            "id": "c705fb4e-5a7c-4dbc-b2e7-f593c988171d",
            "name": "oda",
            "links": {
                "pixiv": null,
                "twitter": null,
                "website": null,
                "youtube": null
            },
            "biography": null,
            "image_url": null
        }
    },
    "meta": {
        "timestamp": "2026-06-07T16:46:54.763Z",
        "request_id": "db253ea3-870e-48aa-9167-5c00e0f77374"
    },
    "status": "ok",
    "message": "Author retrieved successfully",
    "success": true
}
```

### Reference

#### `GET /v1/tags` — All genre & theme tags

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

**Response:**
```json
{
    "data": {
        "tags": [
            {
                "id": "0234a31e-a729-4e28-9d6a-3f87c4966b9e",
                "name": "Oneshot",
                "group": "format"
            },
            {
                "id": "07251805-a27e-4d59-b488-f0bfbec15168",
                "name": "Thriller",
                "group": "genre"
            },
            {
                "id": "0a39b5a1-b235-4886-a747-1d05d216532d",
                "name": "Award Winning",
                "group": "format"
            },
            {
                "id": "0bc90acb-ccc1-44ca-a34a-b9f3a73259d0",
                "name": "Reincarnation",
                "group": "theme"
            },
            {
                "id": "256c8bd9-4904-4360-bf4f-508a76d67183",
                "name": "Sci-Fi",
                "group": "genre"
            },
            {
                "id": "292e862b-2d17-4062-90a2-0356caa4ae27",
                "name": "Time Travel",
                "group": "theme"
            },
            {
                "id": "2bd2e8d0-f146-434a-9b51-fc9ff2c5fe6a",
                "name": "Genderswap",
                "group": "theme"
            },
            {
                "id": "2d1f5d56-a1e5-4d0d-a961-2193588b08ec",
                "name": "Loli",
                "group": "theme"
            },
            {
                "id": "31932a7e-5b8e-49a6-9f12-2afa39dc544c",
                "name": "Traditional Games",
                "group": "theme"
            },
       
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Spec

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

**Response:**
```json
{
    "data": {
        "service": "mangadex-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/tags": "All manga tags (genres & themes).",
            "GET /v1/manga": "Manga detail by id.",
            "GET /v1/author": "Author detail by id.",
            "GET /v1/search": "Search manga by title.",
            "GET /v1/chapter": "Chapter detail by id.",
            "GET /v1/chapter/pages": "Page image URLs for a chapter (reader).",
            "GET /v1/manga/chapters": "A manga's chapter feed (lang=, order=)."
        },
        "description": "MangaDex: search manga, manga detail (cover, author, tags), a manga's chapter feed, chapter detail, a chapter's page-image URLs (reader), author detail and the tag list. Real live data, no key."
    },
    "meta": {
        "timestamp": "2026-06-07T16:46:54.977Z",
        "request_id": "03e8f98f-5c14-4462-a935-e42b4a66504f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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