Search for creators

Use search to search for a creator.

Be sure to include filterForTypes: CREATOR as an argument (By default search does not include searching for creators)

Example:

1. Searching for creators that include the term “Zachary” in their name or bio.

{
  search(term:"Zachary", filterForTypes:CREATOR){
    searchId
    creators{
      uuid
      sssUrl
      name
      bio
    }
  }
}

2. Searching for creators using the term “Zachary” and filter only those who make content in Canada

{
  search(term:"Zachary", filterForTypes:CREATOR, filterForCountries:UNITED_STATES_OF_AMERICA){
    searchId
    creators{
      uuid
      sssUrl
      name
      bio
    }
  }
}

Query Breakdown:

For search, you can search for creators 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 results that are published after a certain date (Epoch time in seconds)"
filterForPublishedAfter: 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 creators with a specific role in creating the content. This filter is only for CREATOR and will return an empty array for any other type "
filterForContentRoles: [ContentRole]

" (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 Creators that match your search term.

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

" A list of Creator items "
creator: [Creator]

" 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.