Endpoints
Buscar obras
GET/api/v1/series
Lista obras del catálogo ordenadas por título. Con q devuelve sólo las que contienen ese texto en el título romaji; la búsqueda distingue mayúsculas de minúsculas.
| Parámetro | Tipo | Por defecto | Descripción |
|---|
q | texto | — | Texto a buscar en el título romaji. |
limit | entero | 25 | Cuántas obras devolver, hasta 100. |
Pedido
curl "https://mymangabase.com/api/v1/series?q=One&limit=2" \
-H "x-api-key: $MMB_API_KEY"
Respuesta
{
"data": [
{
"slug": "one-piece",
"title": {
"romaji": "One Piece",
"english": "One Piece",
"native": "ONE PIECE"
},
"status": "RELEASING",
"magazine": "Weekly Shōnen Jump",
"start_year": 1997,
"chapter_count": 1192,
"external_ids": {
"anilist": 30013,
"mal": 13,
"mangaupdates": "pb8uwds"
}
}
]
}
Ficha de una obra
GET/api/v1/series/:slug
La ficha completa: títulos, autores, revista, editorial, estado, géneros, tomos con ISBN y fecha, los identificadores en AniList, MyAnimeList y MangaUpdates, y las fuentes de los datos.
| Parámetro | Tipo | Por defecto | Descripción |
|---|
:slug | texto | obligatorio | El slug de la obra, por ejemplo one-piece. |
Pedido
curl "https://mymangabase.com/api/v1/series/one-piece" \
-H "x-api-key: $MMB_API_KEY"
Respuesta
{
"slug": "one-piece",
"title": {
"romaji": "One Piece",
"english": "One Piece",
"native": "ONE PIECE"
},
"authors": [
"Eiichiro Oda"
],
"artists": [
"Eiichiro Oda"
],
"magazine": "Weekly Shōnen Jump",
"publisher": "Shueisha",
"status": "RELEASING",
"start_year": 1997,
"chapter_count": 1192,
"genres": [
"action",
"adventure",
"fantasy",
"pirate-fiction"
],
"volumes": [
{
"number": 1,
"isbn": "4-08-872509-3",
"release_date": "1997-12-24T00:00:00.000Z"
},
{
"number": 2,
"isbn": "4-08-872544-1",
"release_date": "1998-04-03T00:00:00.000Z"
}
],
"external_ids": {
"anilist": 30013,
"mal": 13,
"mangaupdates": "pb8uwds"
},
"sources": [
{
"source": "ANILIST",
"name": "AniList",
"url": "https://anilist.co/manga/30013",
"license": "factual",
"fields": [
"titleRomaji",
"titleNative",
"authors",
"magazine",
"startYear"
]
},
{
"source": "WIKIPEDIA",
"name": "Wikipedia",
"url": "https://en.wikipedia.org/wiki/List_of_One_Piece_chapters_(1016%E2%80%93current)",
"license": "CC BY-SA 4.0",
"fields": [
"titleEnglish",
"titleNative",
"titleRomaji",
"volumeId",
"isbn",
"releaseDate"
]
}
]
}
Capítulos de una obra
GET/api/v1/series/:slug/chapters
Los capítulos ordenados por número, con títulos, tomo, fecha, sinopsis y puntaje. total es la cantidad de capítulos de la obra: con limit y offset se recorren de a páginas.
| Parámetro | Tipo | Por defecto | Descripción |
|---|
:slug | texto | obligatorio | El slug de la obra. |
limit | entero | 100 | Cuántos capítulos devolver, hasta 500. |
offset | entero | 0 | Cuántos capítulos saltear desde el principio. |
Pedido
curl "https://mymangabase.com/api/v1/series/one-piece/chapters?limit=2&offset=1000" \
-H "x-api-key: $MMB_API_KEY"
Respuesta
{
"total": 1192,
"offset": 1000,
"limit": 2,
"data": [
{
"id": "522fe676-166f-4560-b8ba-8023f1a92d83",
"number": 1001,
"slug": "1001",
"title": {
"english": "Battle of Monsters on Onigashima",
"native": "鬼ヶ島怪物決戦",
"romaji": "Onigashima Kaibutsu Kessen"
},
"volume": 99,
"magazine_issue": null,
"jp_release_date": null,
"page_count": null,
"is_extra": false,
"synopsis": null,
"rating": {
"average": 0,
"bayesian": 0,
"count": 0
}
},
{
"id": "2aceff2d-3f84-4382-9140-05c904c0ad94",
"number": 1002,
"slug": "1002",
"title": {
"english": "Four Emperors vs. New Generation",
"native": "四皇VS新世代",
"romaji": "Yonkō Bāsasu Shinsedai"
},
"volume": 99,
"magazine_issue": null,
"jp_release_date": null,
"page_count": null,
"is_extra": false,
"synopsis": null,
"rating": {
"average": 8.2,
"bayesian": 7.66332,
"count": 15
}
}
]
}
Un capítulo
GET/api/v1/chapters/:id
Todo sobre un capítulo: los datos de la lista más sus publicaciones (revista, tomo, digital), los personajes que aparecen y las fuentes.
| Parámetro | Tipo | Por defecto | Descripción |
|---|
:id | texto | obligatorio | El id del capítulo, que devuelve la lista de capítulos. |
Pedido
curl "https://mymangabase.com/api/v1/chapters/2aceff2d-3f84-4382-9140-05c904c0ad94" \
-H "x-api-key: $MMB_API_KEY"
Respuesta
{
"id": "2aceff2d-3f84-4382-9140-05c904c0ad94",
"series": {
"slug": "one-piece",
"titleRomaji": "One Piece"
},
"number": 1002,
"title": {
"english": "Four Emperors vs. New Generation",
"native": "四皇VS新世代",
"romaji": "Yonkō Bāsasu Shinsedai"
},
"volume": {
"number": 99,
"isbn": "978-4-08-882691-2"
},
"magazine_issue": null,
"jp_release_date": null,
"page_count": null,
"synopsis": null,
"rating": {
"average": 8.2,
"bayesian": 7.66332,
"count": 15
},
"releases": [
{
"kind": "MAGAZINE",
"language": "ja",
"group": null,
"date": null
}
],
"characters": [
{
"id": "…",
"slug": "monkey-d-luffy",
"name": "Monkey D. Luffy",
"role": "MAIN"
}
],
"sources": [
{
"source": "WIKIPEDIA",
"url": "https://en.wikipedia.org/wiki/List_of_One_Piece_chapters_(1016%E2%80%93current)",
"license": "CC BY-SA 4.0",
"fields": [
"titleEnglish",
"titleNative",
"titleRomaji"
]
}
]
}
Publicados hace poco
GET/api/v1/weekly
Los capítulos publicados en los últimos días, del más nuevo al más viejo, hasta 200. Si un capítulo no tiene fecha propia se usa la del tomo que lo recopila, y date_source dice cuál de las dos es: chapter o volume.
| Parámetro | Tipo | Por defecto | Descripción |
|---|
days | entero | 7 | Cuántos días hacia atrás, hasta 60. |
Pedido
curl "https://mymangabase.com/api/v1/weekly?days=30" \
-H "x-api-key: $MMB_API_KEY"
Respuesta
{
"since": "2026-08-16T14:01:38.672Z",
"data": [
{
"id": "1d2bce5e-4eb9-48e3-be02-39446134eddc",
"series": {
"slug": "kagurabachi",
"titleRomaji": "Kagurabachi"
},
"number": 113,
"title": "Rock",
"jp_release_date": "2026-09-04T00:00:00.000Z",
"date_source": "volume",
"rating": {
"bayesian": 0,
"count": 0
}
}
]
}