Search for comics

Use search to search through all comics.

Be sure to include filterForTypes: COMICSERIES as an argument (By default search does not search for comics)

Examples:

1. Searching for comics that match the term "Warrior's Strife"

{
  search(term:"Warrior's Strife", filterForTypes:COMICSERIES){
    searchId
    comicSeries{
      uuid
      name
      sssUrl
    }
  }
}

Filtering

You have the ability to filter for results from a specific country, genre, language, before or after a certain publish date, before or after the latest episode was published, You can see the full list of filtering options available in the Query Breakdown section below.

2. Searching for comics in the Romance Genre

{
  search(filterForTypes:COMICSERIES, filterForGenres:COMICSERIES_ROMANCE){
    searchId
    comicSeries{
      uuid
      name
      sssUrl
    }
  }
}

3. Searching for comics with tags “Monsterlovers” or “Monster lovers”

{
  search(filterForTypes:COMICSERIES, filterForTags:["Monsterlovers", "Monster lovers"]){
    searchId
    comicSeries{
      uuid
      name
      sssUrl
    }
  }
}

Pagination

4. Searching for page 2 of comics with tags “Monsterlovers” or “Monster lovers”


{
  search(filterForTypes:COMICSERIES, filterForGenres:COMICSERIES_ROMANCE, page:2, limitPerPage:25){
    searchId
    comicSeries{
      uuid
      name
      sssUrl
    }
  }
}

Query Breakdown:

For search, you can search for podcasts or episodes using theses properties:

" The term you are searching for "
term: String

" (Optional) Allows for pagination. Default is 1 (ie: page 1 of the results). Max value is 20. "
page: Int

" (Optional) The number of results per page. Default is 10. Max value is 25 (ie: that max results you can return in one query in 25) "
limitPerPage: Int

" (Optional) Filter for certain types of content. Default is PODCASTSERIES. Possible values are PODCASTSERIES, PODCASTEPISODE, COMICSERIES, CREATOR "
filterForTypes: [SearchContentType]

" (Optional) Filter for only content made in certain countries "
filterForCountries: [Country]

" (Optional) Filter for only content made in certain languages "
filterForLanguages: [Language]

" (Optional) Filter for only content from certain genres "
filterForGenres: [Genre]

" (Optional) Filter for results only from certain series "
filterForSeriesUuids: [ID]

" (Optional) Filter for results that are not from certain series "
filterForNotInSeriesUuids: [ID]

" (Optional) Filter for content that have an episode published after a certain date (Epoch time in seconds). This filter is only for PODCASTSERIES & COMICSERIES and will return an empty array for any other type "
filterForLastUpdatedAfter: Int

" (Optional) Filter for results that have an episode published before a certain date (Epoch time in seconds). This filter is only for PODCASTSERIES & COMICSERIES and will return an empty array for any other type "
filterForLastUpdatedBefore: Int

" (Optional) Filter for only content that includes a certain tag. Tags are case sensitive and must be exact matches. This filter is only for COMICSERIES & CREATOR and will return an empty array for any other type "
filterForTags: [String]

" (Optional) Filter for only content that has a certain content rating. This filter is only for COMICSERIES and will return an empty array for any other types. For PODCASTSERIES & PODCASTEPISODE use isSafeMode "
filterForContentRatings: [ContentRating]

" (Optional) Filter for if a comic's series type is WEBTOON, MANGA, etc. Default is null (include all comic types). This filter is only for COMICSERIES and will return an empty array for any other type "
filterForComicSeriesType: [ComicSeriesType]

" (Optional) Filter for if a comic's series layout is VERTICAL_SCROLL_TOP_TO_BOTTOM or PAGE etc. Default is null (include all comic layouts). This filter is only for COMICSERIES and will return an empty array for any other type "
filterForComicSeriesLayout: [ComicSeriesLayout]

" (Optional) Filter for only content that has a certain total number of issues. This filter is only for COMICSERIES and will return an empty array for any other type "
filterForTotalIssuesLessThan: Int

" (Optional) Filter for only content that has a certain total number of issues. This filter is only for COMICSERIES and will return an empty array for any other type "
filterForTotalIssuesGreaterThan: Int

" (Optional) Filter for only content that has a certain scopes for exclusive content. This filter is only for COMICSERIES and will return an empty array for any other type "
filterForExclusiveContent: [String]

" (Optional) Choose how the results are sorted. Default is sort by EXACTNESS. Possible values are EXACTNESS and POPULARITY. "
sortBy: SearchSortOrder

" (Optional) Choose which results are matched as valid search results. Default is MOST_TERMS. Possible values are MOST_TERMS, ALL_TERMS, FREQUENCY. If you search has multiple terms, FREQUENCY gives more weight to the terms that appear less frequently in results "
matchBy: SearchMatchType

" (Optional) Choose to only return safe (not explicit) content or all content. Default is false (include everything, including explicit content) "
isSafeMode: Boolean

The response you get back includes an array of ComicSeries that match your search term.


" Identifier for the search query being sent "
searchId: ID!

" A list of ComicSeries items "
comicSeries: [ComicSeries]

" Ranking information for each search result "
rankingDetails: [SearchRankingDetails]

" Additional information on the search results (Total # of results, pages, etc) "
responseDetails: [SearchResponseDetails]

Referenced types in this document:

👋

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