Skip to content

Comics ​

A comic is a series of chapters made of page images, created with Civitai's comic creator. These endpoints serve the same published comics as the site's public comic reader, so an app can show comics without the reader downloading them.

Public, edge-cached, rate-limited

All three endpoints are public. They always evaluate the request as anonymous, so a token is optional and never changes the data you get back: the result depends only on the URL and your region. Responses are edge-cached (public, s-maxage=300) and conservatively rate-limited. On a 429, wait for the time in the Retry-After header.

You only ever get what the public reader shows a signed-out visitor:

  • Comics are published, not removed, and by creators in good standing.
  • Chapters are published, and their pages have finished scanning.
  • Mature content appears only with nsfw=true, and it is clamped to SFW in restricted regions.

If comics are not available to signed-out visitors on the site, every endpoint here returns 404.

Downloads

Every comic carries allowDownload: the creator's choice of whether readers may save it. Pages are served either way, for reading. When allowDownload is false, your app must not offer to save, export or cache the pages for offline use.

Maturity ​

Each comic, chapter and page has an nsfwLevel, a bit flag (1 = PG, 2 = PG-13, 4 = R, 8 = X, 16 = XXX). A comic's level combines all its chapters.

  • Without nsfw: only comics whose every chapter is PG are listed or served, in every region. Any other comic is a 404.
  • With nsfw=true: every level is served, except in a restricted region, where it is clamped to PG and PG-13. The response is private, no-store, because it depends on your region.

A page whose image falls outside your level has url: null. It keeps its place in the chapter.

List comics ​

GET /api/v1/comics

Auth: Public.

Query parameters ​

NameTypeDefaultDescription
limitinteger (1–50)20Number of comics per page.
cursorstring—Use metadata.nextCursor from the previous response. Cursor-based pagination only.
sortNewest | MostFollowed | MostChaptersNewestSort order. Newest is by last update.
periodDay | Week | Month | Year | AllTime—Only comics updated within the period.
genrestring—A comic genre, e.g. Fantasy, SciFi, Mystery.
usernamestring—Only this creator's comics. An unknown username returns no items.
nsfwbooleanfalseInclude mature comics. See Maturity.

An invalid parameter returns 400, as does a cursor that is not one this endpoint returned for the same sort.

Response ​

Envelope: { items, metadata: { nextCursor, nextPage } }. nextCursor and nextPage are omitted on the last page.

json
{
  "items": [
    {
      "id": 4336,
      "name": "The Comic Machine",
      "description": "Technology runs amok.",
      "genre": "SciFi",
      "url": "https://civitai.com/comics/4336/the-comic-machine",
      "nsfwLevel": 1,
      "coverImage": {
        "url": "https://image.civitai.com/.../width=450/145533600.jpeg",
        "nsfwLevel": 1
      },
      "user": { "username": "some-creator" },
      "chapterCount": 1,
      "followerCount": 0,
      "readerCount": 234,
      "updatedAt": "2026-10-21T15:41:03.693Z",
      "allowDownload": true
    }
  ],
  "metadata": {
    "nextCursor": "4336",
    "nextPage": "https://civitai.com/api/v1/comics?limit=20&cursor=4336"
  }
}

coverImage is null when the comic has none, when the cover is above your level, or while the cover image is still being checked.

Example ​

bash
curl "https://civitai.com/api/v1/comics?limit=5&sort=MostFollowed"
GET

Get a comic ​

GET /api/v1/comics/{id}

Auth: Public.

Parameters ​

NameInTypeDescription
idpathintegerComic ID.
nsfwquerybooleanInclude a mature comic. See Maturity.

Response ​

The comic's fields (as in the list, without genre, chapterCount and updatedAt), plus its published chapters in reading order. Page images are not included; fetch a chapter for those.

json
{
  "id": 4336,
  "name": "The Comic Machine",
  "description": "Technology runs amok.",
  "url": "https://civitai.com/comics/4336/the-comic-machine",
  "nsfwLevel": 1,
  "allowDownload": true,
  "coverImage": { "url": "https://image.civitai.com/.../width=450/145533600.jpeg", "nsfwLevel": 1 },
  "user": { "username": "some-creator" },
  "followerCount": 0,
  "readerCount": 234,
  "chapters": [
    {
      "number": 1,
      "name": "Chapter 1",
      "publishedAt": "2026-10-13T10:53:05.931Z",
      "nsfwLevel": 1,
      "pageCount": 12,
      "earlyAccessEndsAt": null,
      "url": "https://civitai.com/comics/4336/the-comic-machine/1/chapter-1"
    }
  ]
}

earlyAccessEndsAt is set while a chapter is in early access, which is paid access for supporters before the chapter is free. Its pages are refused until that time.

Returns 404 if the comic doesn't exist, isn't public, or is above your level. The three cases look the same.

Example ​

bash
curl "https://civitai.com/api/v1/comics/4336"
GET

Get a chapter's pages ​

GET /api/v1/comics/{id}/chapters/{number}

Auth: Public.

Parameters ​

NameInTypeDescription
idpathintegerComic ID.
numberpathintegerChapter number as the site shows it, from 1.
nsfwquerybooleanInclude mature content. See Maturity.

Response ​

json
{
  "comicId": 4336,
  "series": "The Comic Machine",
  "number": 1,
  "name": "Chapter 1",
  "writer": "some-creator",
  "nsfwLevel": 1,
  "publishedAt": "2026-10-13T10:53:05.931Z",
  "allowDownload": true,
  "url": "https://civitai.com/comics/4336/the-comic-machine/1/chapter-1",
  "pages": [
    {
      "number": 1,
      "url": "https://image.civitai.com/.../width=1600/53689.jpeg",
      "width": 1184,
      "height": 896,
      "nsfwLevel": 1
    }
  ]
}

series, name, number and writer match the fields a ComicInfo.xml carries. Page images are served at up to 1600 px wide. width and height are the original image's size.

StatusWhen
200The chapter's pages.
403The chapter is in early access: { "error": "...", "earlyAccessEndsAt": "..." }. Retry after that time.
404The comic or chapter doesn't exist, isn't public, or is above your level.

Example ​

bash
curl "https://civitai.com/api/v1/comics/4336/chapters/1"
GET

Civitai Developer Documentation