Endpoints
Search series
GET/api/v1/series
Lists catalogue series ordered by title. With q it returns only those whose romaji title contains that text; the search is case-sensitive.
| Parameter | Type | Default | Description |
|---|
q | string | — | Text to look for in the romaji title. |
limit | integer | 25 | How many series to return, up to 100. |
Request
curl "https://mymangabase.com/api/v1/series?q=One&limit=2" \
-H "x-api-key: $MMB_API_KEY"
Response
{
"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"
}
}
]
}
Series record
GET/api/v1/series/:slug
The full record: titles, authors, magazine, publisher, status, genres, volumes with ISBN and date, the AniList, MyAnimeList and MangaUpdates ids, and the data sources.
| Parameter | Type | Default | Description |
|---|
:slug | string | required | The series slug, for example one-piece. |
Request
curl "https://mymangabase.com/api/v1/series/one-piece" \
-H "x-api-key: $MMB_API_KEY"
Response
{
"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"
]
}
]
}
Chapters of a series
GET/api/v1/series/:slug/chapters
Chapters ordered by number, with titles, volume, date, synopsis and rating. total is the series' chapter count: page through them with limit and offset.
| Parameter | Type | Default | Description |
|---|
:slug | string | required | The series slug. |
limit | integer | 100 | How many chapters to return, up to 500. |
offset | integer | 0 | How many chapters to skip from the start. |
Request
curl "https://mymangabase.com/api/v1/series/one-piece/chapters?limit=2&offset=1000" \
-H "x-api-key: $MMB_API_KEY"
Response
{
"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
}
}
]
}
A chapter
GET/api/v1/chapters/:id
Everything about one chapter: the list data plus its releases (magazine, volume, digital), the characters who appear and the sources.
| Parameter | Type | Default | Description |
|---|
:id | string | required | The chapter id, returned by the chapter list. |
Request
curl "https://mymangabase.com/api/v1/chapters/2aceff2d-3f84-4382-9140-05c904c0ad94" \
-H "x-api-key: $MMB_API_KEY"
Response
{
"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"
]
}
]
}
Recently released
GET/api/v1/weekly
Chapters released in the last few days, newest first, up to 200. When a chapter has no date of its own the date of the volume collecting it is used, and date_source says which one it is: chapter or volume.
| Parameter | Type | Default | Description |
|---|
days | integer | 7 | How many days back, up to 60. |
Request
curl "https://mymangabase.com/api/v1/weekly?days=30" \
-H "x-api-key: $MMB_API_KEY"
Response
{
"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
}
}
]
}