{"openapi":"3.1.0","info":{"title":"Mangainfo API","version":"1.0.0","summary":"Free, read only API for English manga release dates, volumes and ISBNs.","description":"Every English manga volume Mangainfo lists, with its release date, ISBN, publisher and format, and how far the English edition is against Japan. No key and no account. Any origin may call it from a browser. 60 requests a minute per address. Dates keep the precision of the source: 2026-11-03 is a day, 2026-11 a month, 2026 a year. Credit \"Data: Mangainfo\" with a link to the page in the source object of each answer.","termsOfService":"https://mangainfo.com/terms","contact":{"name":"Mangainfo","url":"https://mangainfo.com/api","email":"kontakt@mangaverden.dk"},"license":{"name":"Free use with attribution to Mangainfo","url":"https://mangainfo.com/terms"}},"servers":[{"url":"https://mangainfo.com/api/v1","description":"Mangainfo"}],"externalDocs":{"description":"Documentation with examples","url":"https://mangainfo.com/api"},"tags":[{"name":"Series","description":"Manga series with a page on Mangainfo."},{"name":"Releases","description":"English editions by release date."},{"name":"Volumes","description":"One book by ISBN."},{"name":"Licenses","description":"Series that come to English, by year."},{"name":"Report","description":"Release statistics by year."}],"paths":{"/series":{"get":{"tags":["Series"],"operationId":"searchSeries","summary":"Search series by title","description":"Series whose English, romaji, native or other title holds q. An exact title comes first, then the most popular. Without q every series is listed by popularity. 20 per page.","parameters":[{"name":"q","in":"query","required":false,"description":"A title or part of one.","schema":{"type":"string","maxLength":100},"example":"blue lock"},{"$ref":"#/components/parameters/Page"}],"responses":{"200":{"description":"Matching series.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links","source"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SeriesSummary"}},"meta":{"$ref":"#/components/schemas/SearchMeta"},"links":{"$ref":"#/components/schemas/PageLinks"},"source":{"$ref":"#/components/schemas/Source"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/series/{slug}":{"get":{"tags":["Series"],"operationId":"getSeries","summary":"Get one series","description":"Titles, status in Japan and in English, volumes out in Japan and in English, the latest and the next English volumes, creators, English publishers and the addresses of the page, the badge, the widget and the feed.","parameters":[{"$ref":"#/components/parameters/Slug"}],"responses":{"200":{"description":"The series.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","links","source"],"properties":{"data":{"$ref":"#/components/schemas/Series"},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"source":{"$ref":"#/components/schemas/Source"}}}}}},"304":{"description":"Not modified. The ETag in If-None-Match still matches."},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/series/{slug}/volumes":{"get":{"tags":["Series"],"operationId":"getSeriesVolumes","summary":"List the volumes of a series","description":"Each Japanese volume with a number and the English editions that hold it. An omnibus is listed under every volume it holds.","parameters":[{"$ref":"#/components/parameters/Slug"}],"responses":{"200":{"description":"The volumes.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links","source"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Volume"}},"meta":{"type":"object","required":["series"],"properties":{"series":{"$ref":"#/components/schemas/SeriesReference"}}},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"source":{"$ref":"#/components/schemas/Source"}}}}}},"304":{"description":"Not modified."},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/series/{slug}/anime":{"get":{"tags":["Series"],"operationId":"getSeriesAnime","summary":"Where the anime of a series ends in the manga","description":"The chapters each TV season or film of the anime adapts, as an editor checked them, the chapter and Japanese volume to read on from, and the English edition of that volume. Chapter numbers come from English Wikipedia (CC BY-SA 4.0) with the page in source. 404 for a series without checked ranges.","parameters":[{"$ref":"#/components/parameters/Slug"}],"responses":{"200":{"description":"The seasons with their chapters.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links","source"],"properties":{"data":{"$ref":"#/components/schemas/AnimeEnd"},"meta":{"type":"object","required":["series"],"properties":{"series":{"$ref":"#/components/schemas/SeriesReference"}}},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"source":{"$ref":"#/components/schemas/Source"}}}}}},"304":{"description":"Not modified."},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/releases":{"get":{"tags":["Releases"],"operationId":"getReleases","summary":"English editions released in a date window","description":"English editions dated to a day inside the window, and editions dated only to a month that overlaps it. At most 62 days. 100 per page, by date.","parameters":[{"name":"from","in":"query","required":false,"description":"First day. Default today (UTC).","schema":{"type":"string","format":"date"},"example":"2026-11-01"},{"name":"to","in":"query","required":false,"description":"Last day. Default 30 days after from.","schema":{"type":"string","format":"date"},"example":"2026-11-30"},{"$ref":"#/components/parameters/Page"}],"responses":{"200":{"description":"The editions.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links","source"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Release"}},"meta":{"$ref":"#/components/schemas/ReleasesMeta"},"links":{"$ref":"#/components/schemas/PageLinks"},"source":{"$ref":"#/components/schemas/Source"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/volumes/{isbn}":{"get":{"tags":["Volumes"],"operationId":"lookupIsbn","summary":"Look up a volume by ISBN","description":"The English edition with this ISBN-13 or ISBN-10, or the Japanese volume with it, with the volume, every English edition of the volume and the series.","parameters":[{"name":"isbn","in":"path","required":true,"description":"ISBN-13 or ISBN-10, hyphens allowed.","schema":{"type":"string","pattern":"^[0-9Xx-]{10,17}$"},"example":"9781646516544"}],"responses":{"200":{"description":"The volume.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","links","source"],"properties":{"data":{"$ref":"#/components/schemas/IsbnMatch"},"links":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"source":{"$ref":"#/components/schemas/Source"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/licenses":{"get":{"tags":["Licenses"],"operationId":"getLicenses","summary":"Series whose first English edition comes out in a year","description":"The license tracker: series whose first English edition from a manga publisher, holding volume 1, comes out in the year, in date order. The date is the release date of that book, not the day a license was announced.","parameters":[{"name":"year","in":"query","required":false,"description":"The year. Default this year (UTC).","schema":{"type":"integer","minimum":1900,"maximum":2099},"example":2026}],"responses":{"200":{"description":"The series.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links","source"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/License"}},"meta":{"type":"object","required":["year","total","released","upcoming","definition"],"properties":{"year":{"type":"integer"},"total":{"type":"integer"},"released":{"type":"integer"},"upcoming":{"type":"integer"},"definition":{"type":"string"}}},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"page":{"type":"string","format":"uri"},"feed":{"type":"string","format":"uri"}}},"source":{"$ref":"#/components/schemas/Source"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/report/{year}":{"get":{"tags":["Report"],"operationId":"getReport","summary":"The English Manga Report of a year","description":"Release statistics computed from the catalog: new English volumes per month and per publisher, months from the Japanese release to the first English edition (median and average, per publisher, fastest and slowest series), series started and finished in English. A volume counts once, in the month of its first English edition from a manga publisher. Lags count calendar months and only volumes dated at least to the month on both sides.","parameters":[{"name":"year","in":"path","required":true,"description":"The year.","schema":{"type":"integer","minimum":1900,"maximum":2099},"example":2026}],"responses":{"200":{"description":"The report.","headers":{"ETag":{"$ref":"#/components/headers/ETag"},"Cache-Control":{"$ref":"#/components/headers/Cache-Control"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta","links","source"],"properties":{"data":{"type":"object","required":["year","generated_at","complete","totals","months","publishers","lag","started","finished"],"properties":{"year":{"type":"integer"},"generated_at":{"type":"string","format":"date-time"},"today":{"type":"string","format":"date"},"complete":{"type":"boolean","description":"Whether the year is over."},"last_month":{"type":"integer"},"totals":{"type":"object","description":"volumes (dated in the year), released, dated_ahead, month_unknown, editions (every shown edition dated to a month), series and publishers."},"compare":{"type":["object","null"],"description":"Released volumes against the year before over the same full months: through_month, current, previous."},"months":{"type":"array","items":{"type":"object","description":"month, key, volumes, released, editions, scheduled and details (publishers, series, lag)."}},"publishers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"volumes":{"type":"integer"},"share":{"type":"number"}}}},"lag":{"type":"object","description":"volumes, median and average months, left_out counts, publishers, fastest and slowest series."},"busiest_month":{"type":["object","null"]},"busiest_series_month":{"type":["object","null"]},"started":{"type":"object","description":"Series with their first English edition in the year (released) and the count dated later (dated_ahead)."},"finished":{"type":"array","items":{"type":"object"}}}},"meta":{"type":"object","properties":{"years":{"type":"array","items":{"type":"integer"}},"method":{"type":"string","format":"uri"}}},"links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"page":{"type":"string","format":"uri"},"dataset":{"type":"string","format":"uri"}}},"source":{"$ref":"#/components/schemas/Source"}}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}},"components":{"parameters":{"Slug":{"name":"slug","in":"path","required":true,"description":"The last part of the series address: mangainfo.com/series/blue-lock is blue-lock.","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"example":"blue-lock"},"Page":{"name":"page","in":"query","required":false,"description":"Page number, from 1.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}}},"headers":{"ETag":{"description":"Send it back in If-None-Match to get 304 while nothing changed.","schema":{"type":"string"}},"Cache-Control":{"description":"public, max-age=300, s-maxage=3600, never past midnight UTC.","schema":{"type":"string"}},"X-RateLimit-Remaining":{"description":"Requests left this minute.","schema":{"type":"integer"}}},"responses":{"BadRequest":{"description":"A parameter is wrong.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"NotFound":{"description":"No series or volume with a page on Mangainfo.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"TooManyRequests":{"description":"More than 60 requests a minute from one address.","headers":{"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"schemas":{"Precision":{"type":["string","null"],"enum":["day","month","year",null],"description":"How exact release_date is. A month is never turned into a day."},"PartialDate":{"type":["string","null"],"pattern":"^\\d{4}(-\\d{2}(-\\d{2})?)?$","description":"2026-11-03, 2026-11 or 2026, as exact as the source.","examples":["2026-11-03","2026-11"]},"Source":{"type":"object","description":"Who the data is from and what to credit.","required":["name","url","attribution","license"],"properties":{"name":{"const":"Mangainfo"},"url":{"type":"string","format":"uri","description":"The Mangainfo page to link to."},"home":{"type":"string","format":"uri"},"attribution":{"type":"string","examples":["Data: Mangainfo (https://mangainfo.com/series/blue-lock)"]},"license":{"type":"string"},"third_party":{"type":"string"},"terms":{"type":"string","format":"uri"},"data_sources":{"type":"string","format":"uri"}}},"Problem":{"type":"object","description":"Problem details, RFC 9457.","required":["type","title","status","detail"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"source":{"$ref":"#/components/schemas/Source"}}},"PageLinks":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"next":{"type":["string","null"],"format":"uri"},"prev":{"type":["string","null"],"format":"uri"}}},"SearchMeta":{"type":"object","properties":{"query":{"type":"string"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"}}},"ReleasesMeta":{"type":"object","properties":{"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"pages":{"type":"integer"}}},"VolumeDate":{"type":["object","null"],"description":"An English edition as a badge names it: the volumes it holds and its date.","properties":{"volumes":{"type":"array","items":{"type":"integer"}},"label":{"type":"string","examples":["Vol. 14","Vols. 4 to 6"]},"release_date":{"$ref":"#/components/schemas/PartialDate"},"precision":{"$ref":"#/components/schemas/Precision"},"edition_label":{"type":["string","null"],"examples":["Paperback","Digital"]},"url":{"type":"string","format":"uri"}}},"SeriesReference":{"type":"object","required":["slug","title","url","api_url"],"properties":{"slug":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"}}},"SeriesSummary":{"type":"object","required":["slug","title","url","api_url"],"properties":{"slug":{"type":"string","examples":["blue-lock"]},"title":{"type":"string","description":"The English title, else the romaji title."},"titles":{"type":"object","properties":{"english":{"type":["string","null"]},"romaji":{"type":"string"},"native":{"type":["string","null"]},"other":{"type":"array","items":{"type":"string"}}}},"url":{"type":"string","format":"uri"},"api_url":{"type":"string","format":"uri"},"status_japan":{"type":["string","null"],"enum":["releasing","finished","hiatus","cancelled","not_yet_released",null]},"status_english":{"type":"string","enum":["complete","caught_up","behind","in_english","upcoming","unknown"],"description":"complete: finished in Japan and every volume out in English. caught_up: every Japanese volume so far is out in English. behind: Japan is ahead. in_english: volumes are out in English, the Japanese count is not known. upcoming: none out yet, one has a date. unknown: neither."},"volumes_japan":{"type":["integer","null"]},"volumes_english":{"type":["integer","null"]},"latest_english":{"$ref":"#/components/schemas/VolumeDate"},"next_english":{"$ref":"#/components/schemas/VolumeDate"}}},"Series":{"allOf":[{"$ref":"#/components/schemas/SeriesSummary"},{"type":"object","properties":{"upcoming_english":{"type":"array","items":{"$ref":"#/components/schemas/VolumeDate"}},"volumes_behind_japan":{"type":["integer","null"]},"status_japan_label":{"type":["string","null"],"examples":["Releasing in Japan"]},"genres":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"],"description":"Written by Mangainfo and fact checked. Quote it with credit."},"creators":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"As the English editions print it."},"role":{"type":"string","enum":["story_and_art","story","art","original_creator"]},"url":{"type":"string","format":"uri"}}}},"publishers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":["string","null"],"format":"uri"}}}},"links":{"type":"object","properties":{"page":{"type":"string","format":"uri"},"volumes":{"type":"string","format":"uri"},"badge":{"type":"string","format":"uri"},"widget":{"type":"string","format":"uri"},"countdown":{"type":"string","format":"uri"},"feed":{"type":"string","format":"uri"}}}}}]},"Edition":{"type":"object","required":["volumes","label","release_date","precision","url"],"properties":{"volumes":{"type":"array","items":{"type":"integer"},"description":"The Japanese volumes the book holds."},"label":{"type":"string","examples":["Vol. 1","Vols. 1 to 3"]},"title":{"type":["string","null"]},"edition_label":{"type":["string","null"],"description":"What sets the edition apart from the other editions of its volume.","examples":["Paperback","Digital","Hardcover, deluxe edition"]},"format":{"type":["string","null"],"enum":["paperback","hardcover","omnibus","box_set","digital","light_novel",null]},"publisher":{"type":["string","null"]},"isbn13":{"type":["string","null"]},"isbn10":{"type":["string","null"]},"release_date":{"$ref":"#/components/schemas/PartialDate"},"precision":{"$ref":"#/components/schemas/Precision"},"released":{"type":["boolean","null"],"description":"Null when the date cannot be shown."},"url":{"type":"string","format":"uri","description":"The volume page."}}},"Volume":{"type":"object","required":["number","label","url","japan","english"],"properties":{"number":{"type":"integer"},"label":{"type":"string"},"url":{"type":"string","format":"uri"},"japan":{"type":"object","properties":{"release_date":{"$ref":"#/components/schemas/PartialDate"},"precision":{"$ref":"#/components/schemas/Precision"},"isbn13":{"type":["string","null"]},"chapters":{"description":"The main chapters the Japanese volume holds, from the series' chapter list on English Wikipedia (CC BY-SA 4.0). Side stories numbered apart are not counted. Null when not known.","oneOf":[{"type":"null"},{"type":"object","required":["from","to"],"properties":{"from":{"type":"integer","minimum":0},"to":{"type":"integer","minimum":0},"source":{"type":["string","null"],"format":"uri","description":"The Wikipedia page that states the chapters."}}}]}}},"english":{"type":"array","items":{"$ref":"#/components/schemas/Edition"}}}},"Release":{"allOf":[{"$ref":"#/components/schemas/Edition"},{"type":"object","required":["series"],"properties":{"series":{"$ref":"#/components/schemas/SeriesReference"}}}]},"IsbnMatch":{"type":"object","required":["isbn13","match","volume","series"],"properties":{"isbn13":{"type":"string"},"match":{"type":"string","enum":["english_edition","japanese_volume"]},"edition":{"oneOf":[{"$ref":"#/components/schemas/Edition"},{"type":"null"}]},"volume":{"$ref":"#/components/schemas/Volume"},"series":{"$ref":"#/components/schemas/SeriesSummary"}}},"License":{"type":"object","required":["series","publisher","first_english","released","status_japan"],"properties":{"series":{"$ref":"#/components/schemas/SeriesReference"},"publisher":{"type":"string","description":"The English publisher of the first edition.","example":"Seven Seas"},"first_english":{"oneOf":[{"$ref":"#/components/schemas/VolumeDate"},{"type":"null"}],"description":"The first English edition: the volumes it holds, its date with precision and its volume page."},"released":{"type":"boolean","description":"Whether the first English edition is out today (UTC)."},"status_japan":{"type":["string","null"],"enum":["releasing","finished","hiatus","cancelled","not_yet_released",null]}}},"AnimeEnd":{"type":"object","required":["answer","seasons","announced"],"properties":{"answer":{"type":"string","description":"The short answer, written from the data."},"seasons":{"type":"array","items":{"type":"object","required":["label","kind","anilist_ids","chapters","volumes","continue_from","source"],"properties":{"label":{"type":"string"},"kind":{"type":"string","enum":["tv","film","ova"]},"anilist_ids":{"type":"array","items":{"type":"integer"},"description":"The AniList anime ids of the season and the cours merged into it."},"start_date":{"$ref":"#/components/schemas/PartialDate"},"end_date":{"$ref":"#/components/schemas/PartialDate"},"episodes":{"type":["integer","null"]},"chapters":{"type":"object","required":["from","to"],"properties":{"from":{"type":"integer"},"to":{"type":"integer"}}},"volumes":{"type":"object","properties":{"from":{"type":["object","null"],"required":["number","url"],"properties":{"number":{"type":"integer"},"url":{"type":"string","format":"uri"}}},"to":{"type":["object","null"],"required":["number","url"],"properties":{"number":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}},"continue_from":{"type":["object","null"],"properties":{"chapter":{"type":"integer"},"volume":{"type":["object","null"],"required":["number","url"],"properties":{"number":{"type":"integer"},"url":{"type":"string","format":"uri"}}},"english":{"type":["object","null"],"properties":{"label":{"type":"string"},"publisher":{"type":["string","null"]},"release_date":{"$ref":"#/components/schemas/PartialDate"},"released":{"type":"boolean"},"url":{"type":"string","format":"uri"}}}}},"notes":{"type":["string","null"]},"source":{"type":"string","format":"uri","description":"The page that states the chapters."}}}},"announced":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"kind":{"type":"string","enum":["tv","film","ova"]}}}}}}}}}