Cults query examples

Create a design.graphql

mutation {
  createCreation(
    name: "Cults Logo"
    description: "A Cults logo, to test the API"
    imageUrls: ["https://wtf.sunfox.org/3d/cults-logo.jpg"]
    fileUrls: ["https://wtf.sunfox.org/3d/cults-logo.stl"]
    locale: EN

    # Identifier for the “Art” category. Check out the list of categories to find their id.
    categoryId: "Q2F0ZWdvcnkvMjM="
    
    # Identifier for the “Fan Art” sub-category of the “Art” category.
    subCategoryIds: ["Q2F0ZWdvcnkvMzc"]

    downloadPrice: 42.5
    currency: EUR

    # Optional: do not provide a license code to use the default ("Cults - Private Use").
    # For priced designs, you can use "cults_cu" or "cults_cu_nd".
    # For free designs check out the full list of licenses.
    licenseCode: "cults_cu"
  ) {
    creation {
      url(locale: EN)
    }
    errors
  }
}

Find discounted designs

{
  creationsBatch(onlyDiscounted: true) {
    results {
      name(locale: EN)
      shortUrl
      price(currency: EUR) { cents }
      discount {
        percentage
        originalPrice(currency: EUR) { cents }
        startAt
        endAt
      }
    }
  }
}

List available licenses.graphql

{
  licenses {
    code
    name(locale: EN)
    url(locale: EN)
    availableOnFreeDesigns
    availableOnPricedDesigns
  }
}

List your sales.graphql

{
  me {
    salesBatch(limit: 3, offset: 0) {
      total
      results {
        creation { name(locale: EN) }
        user { nick }
        income(currency: EUR) { cents }
        createdAt
        payedOutAt
      }
    }
  }
}

Search for a design.graphql

{
  creationsSearchBatch(query: "batman", limit: 3) {
    total
    results {
      name(locale: EN)
      shortUrl
    }
  }
}

Show a design.graphql

{
  creation(slug: "print-in-place-cute-lucky-bunny") {
    name(locale: EN)
    shortUrl
    illustrationImageUrl
    license {
      name(locale: EN)
    }
    category {
      name(locale: EN)
    }
    publishedAt
    viewsCount
    likesCount
    downloadsCount
    tags(locale: EN)
    price(currency: USD) {
      cents
    }
    creator {
      nick
      shortUrl
    }
  }
}

Show a user.graphql

{
  user(nick: "bigovereasy") {
    bio
    shortUrl
    imageUrl
    creationsCount
    creations(limit: 3, sort: BY_LIKES) {
      name(locale: EN)
      shortUrl
      illustrationImageUrl
    }
  }
}

Show categories.graphql

{
  categories {
    id
    name(locale: EN)
    children {
      id
      name(locale: EN)
    }
  }
}

Show latest designs.graphql

{
  creationsBatch(sort: BY_PUBLICATION, limit: 3) {
    results {
      name(locale: EN)
      shortUrl
    }
  }
}

Show your designs and their files.graphql

{
  me {
    creations(limit: 10, offset: 0) { {
      name(locale: EN)
      url(locale: EN)
      illustrationImageUrl
      downloadsCount
      viewsCount
      totalSalesAmount(currency: USD) { cents }
      blueprints {
        fileUrl
        imageUrl
      }
    }
  }
}

Show your likes.graphql

{
  me {
    likedCreations(limit: 10, offset: 0) {
      name(locale: EN)
      url(locale: EN)
    }
  }
}

Update a creation price.graphql

mutation {
  updateCreation(
    id: "…"
    downloadPrice: 4.2
    currency: EUR
  )
}