Get comic details

Use getComicSeries to get details on a specific comic.

Example:

{
  getComicSeries(uuid:"b00c3bc5-2758-483a-942c-4229eb742cb4"){
    uuid
    datePublished
    name
    description
    hash
    issuesHash
    tags
    genres
    language
    seriesType
    contentRating
    sssUrl
    cover_sm: coverImageUrl(variant:SMALL) # if you want to get multiple variant for the same image, you must use an alias
    cover_md: coverImageUrl(variant:MEDIUM)
    cover_lg: coverImageUrl(variant:LARGE)
    bannerImageUrl(variant:SMALL) # if you just need a specific varaint size, no need to use an alias
    thumbnailImageUrl
  	coverImageAsString
    bannerImageAsString
    thumbnailImageAsString
    creators{
      uuid
      name
      sssUrl
    }
    issues{
      uuid
      name
      bannerImageUrl
      thumbnailImageUrl
      storyImageUrls
    }
  }
}

Response from Taddy’s API:

{
  "data": {
    "getComicSeries": {
      "uuid": "b00c3bc5-2758-483a-942c-4229eb742cb4",
      "datePublished": 1683664725,
      "name": "Warrior's Strife",
      "description": "Frayja has trained all her life to become the greatest warrior in her clan. She has been taught to fear and hate elves and their magic. But a day on the battlefield dramatically alters her perspective on reality.",
      "hash": "397b0176c21bff026d7b58e7bf87147626d4b9c2f7c7a6ddb5de467aa8b1c751",
      "issuesHash": "c005d4e0aadf39c1a043ff3be40833480a2adab59cbffd3ea86620da0a21cc97",
      "tags": [
        "fantasy",
        "darkfantasy",
        "lgbtqia",
        "lgbt",
        "monsters",
        "viking",
        "elf",
        "magic",
        "action",
        "drama",
        "medieval"
      ],
      "genres": [
        "COMICSERIES_ROMANCE",
        "COMICSERIES_DRAMA"
      ],
      "language": "ENGLISH",
      "seriesType": "WEBTOON",
      "contentRating": "COMICSERIES_TEENS",
      "sssUrl": "https://taddy.org/feeds/sss/comicseries/b00c3bc5-2758-483a-942c-4229eb742cb4",
      "cover_sm": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/97699676-ece5-4ab5-b089-5288cfa7421c/cover-sm.webp",
      "cover_md": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/97699676-ece5-4ab5-b089-5288cfa7421c/cover-md.webp",
      "cover_lg": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/97699676-ece5-4ab5-b089-5288cfa7421c/cover-lg.webp",
      "bannerImageUrl": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/f8f972c4-6d77-404e-b5c3-5cf37c3172f3/banner-sm.webp",
      "thumbnailImageUrl": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/a1718041-2b8c-42e9-94fe-099ade2b3417/thumbnail.webp",
      "coverImageAsString": "{\"base_url\":\"https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/97699676-ece5-4ab5-b089-5288cfa7421c/\",\"cover_sm\":\"cover-sm.webp\",\"cover_md\":\"cover-md.webp\",\"cover_lg\":\"cover-lg.webp\"}",
      "bannerImageAsString": "{\"base_url\":\"https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/f8f972c4-6d77-404e-b5c3-5cf37c3172f3/\",\"banner_sm\":\"banner-sm.webp\",\"banner_md\":\"banner-md.webp\",\"banner_lg\":\"banner-lg.webp\"}",
      "thumbnailImageAsString": "{\"base_url\":\"https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/a1718041-2b8c-42e9-94fe-099ade2b3417/\",\"thumbnail\":\"thumbnail.webp\"}",
      "creators": [
        {
          "uuid": "cbce3184-9975-4212-9c0f-3b51113b4ad6",
          "name": "Christopher Becker",
          "sssUrl": "https://taddy.org/feeds/sss/creator/cbce3184-9975-4212-9c0f-3b51113b4ad6"
        }
      ],
      "issues": [
        {
          "uuid": "d99eba13-b183-41af-a53d-9dcdda7928d0",
          "name": "Chapter 16",
          "bannerImageUrl": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/f8f972c4-6d77-404e-b5c3-5cf37c3172f3/banner-sm.webp",
          "thumbnailImageUrl": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/7e64ff14-0f5a-4c18-b866-7a6683ca62aa/thumbnail.webp",
          "storyImageUrls": [
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/80b94c50-5ebd-44f0-ade4-d41f2fa7ae49/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/e6201d3b-23d7-4ac2-b3af-a88fc54e986f/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/9822851f-ab59-40d7-bf80-e447809acd60/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/d214683f-3b36-4e9a-a131-ac7d08cab378/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/5e29f90c-74e0-4093-ac49-42fc7fc722d3/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/d277ea8e-993e-45bd-a217-d17168f3ca6d/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/ee67dd53-3521-4d72-8b4f-4697f227ce58/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/1ec0d33a-291d-4ac3-a6c8-969a140a6980/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/d99eba13-b183-41af-a53d-9dcdda7928d0/7c091eb9-ec04-4b1c-ba77-24ffd760b841/story.webp"
          ]
        },
        {
          "uuid": "7996485c-6dc8-4275-90c9-3dcb5db6c961",
          "name": "Chapter 15 (Beginning of Book 3)",
          "bannerImageUrl": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/f8f972c4-6d77-404e-b5c3-5cf37c3172f3/banner-sm.webp",
          "thumbnailImageUrl": "https://ax1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/da9926de-a9bf-4f95-aaea-3f48596190e7/thumbnail.webp",
          "storyImageUrls": [
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/7fd113f2-0ca6-4077-be7f-545a021e458b/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/e363b11e-6c17-4ea5-bff9-37e5490ad1dd/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/c56b90f6-3073-469f-a912-7d52734f9f2b/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/cc6255ec-e853-41d6-ae0a-e157283e53fa/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/e59545a4-db2d-4dd7-9c86-365721b0da7a/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/59ae8760-6894-4e5c-8666-daa310ef3693/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/a2b5917b-e3e1-4599-a681-3092d9f41116/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/2e22f812-f193-484a-868a-c4c30b384517/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/19f4abed-1135-4d80-9469-74a7e43d6b18/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/b922dfde-2fe7-4a30-9eed-c664acfbd35c/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/1aba40d3-f4b8-425a-a33b-4a10c6cc043c/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/b310b286-1526-4c60-b545-45c9f7d3d6d3/story.webp",
            "https://ay1.taddy.org/b00c3bc5-2758-483a-942c-4229eb742cb4/7996485c-6dc8-4275-90c9-3dcb5db6c961/0e827d2c-ff6d-4f1b-9b87-6405e38219fe/story.webp"
          ]
        },
        ...,
      ]
    }
  }
}

Query Breakdown:

For getComicSeries, you can get details on any comic using one of the following properties:

" Unique identifier for a comic "
uuid: ID

" A comic's SSS Feed "
sssUrl: String

" The name (title) of a comic. Note: Multiple comic can have the exact same name, in that case we always try to return the most popular comic (based on the infomation we have)"
name: String

The response you get back is a ComicSeries. That means you can return any of the following details:

" Unique identifier for this comic "
uuid: ID

" Date when the comic was published (Epoch time in seconds) "
datePublished: Int

" The name (title) for a comic "
name: String

" The description for a comic "
description: String

" Status of the comic "
status: SeriesStatus

" The cover art for a comic "
coverImageUrl(
  " (Optional) size / variant. Default is SMALL "
  variant: ImageVariant
):String

" The banner art for a comic "
bannerImageUrl(
  " (Optional) size / variant. Default is SMALL "
  variant: ImageVariant
):String

" The thumbnail art for a comic "
thumbnailImageUrl: String

" Stringified JSON details for the cover art. Convert to JSON to use."
coverImageAsString: String

" Stringified JSON details for the banner art. Convert to JSON to use."
bannerImageAsString: String

" Stringified JSON details for the thumbnail art. Convert to JSON to use."
thumbnailImageAsString: String

" A hash of all comic details. It may be useful for you to save this property in your database and compare it to know if any comic details have updated since the last time you checked "
hash: String

" A hash of the details for all issues for this comic. It may be useful for you to save this property in your database and compare it to know if there are any new or updated issues since the last time you checked "
issuesHash: String

" A list of issues for this comic "
issues(
  " (Optional) Returns issues based on SortOrder. Default is LATEST (newest issues first), another option is OLDEST (oldest issues first), and another option is SEARCH (pass in the property searchTerm) to filter for issues by title or description. "
  sortOrder: SortOrder,

  " (Optional) Taddy paginates the results returned. Default is 1, Max value allowed is 1000 "
  page: Int,

  " (Optional) Return up to this number of issues. Default is 10, Max value allowed is 25 results per page "
  limitPerPage: Int,

  " (Optional) Only to be used when sortOrder is SEARCH. Filters through the title & description of issues for the searchTerm "
  searchTerm: String,

  " (Optional) The option to show issues that were once on the SSS feed but have now been removed. Default is false (do not include removed episodes) "
  includeRemovedIssues: Boolean,
): [ComicIssue]

" The number of issues for this comic "
totalIssuesCount(
  " (Optional) Option to include issues that were once on the SSS feed but have now been removed. Default is false (do not include removed episodes) "
  includeRemovedIssues: Boolean
): Int

" Tags for the comic "
tags: [String]

" A comic can belong to multiple genres but they are listed in order of importance. "
genres: [Genre]

" The language the comic is in "
language: Language

" Creators of the comic "
creators: [Creator]

" Type of the comic "
seriesType: ComicSeriesType

" Layout of the comic "
seriesLayout: ComicSeriesLayout

" Rating of the comic "
contentRating: ContentRating

" Url for the comic's SSS feed "
sssUrl: String

" Name to use for contacting the owner of this feed "
sssOwnerName: String

" Email to use for contacting the owner of this feed "
sssOwnerPublicEmail: String

" Copyright details for this feed "
copyright: String

" Details on how often the SSS feed is checked for new details "
feedRefreshDetails: FeedRefreshDetails

" If the content has violated Taddy's distribution policies for illegal or harmful content it will be blocked from getting any updates "
isBlocked: Boolean

Referenced types in this document:

👋

If you are new to using Taddy’s API, Get Started with our 🤖 Intro to Taddy’s API.