Cults query examples

Add a discount.graphql

mutation {
  createDiscount(
    creationId: "Q3JlYXRpb24vMjIwMjQzMA"
    discountPercentage: 50
    discountEndAt: "2024-09-01T16:59:12+02:00"
  ) {
    discount {
      creation {
        name
        price {
          cents
        }
      }
      originalPrice {
        cents
      }
      percentage
    }
    errors
  }
}

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

{
  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 my printlists.graphql

{
  myself {
    printlistsBatch(limit: 2, offset: 0) {
      total
      results {
        url
        name
        public
        position
      }
    }
  }
}

List your sales.graphql

{
  myself {
    salesBatch(limit: 3, offset: 0) {
      total
      results {
        id
        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") {
    shortUrl
    bio
    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 likes.graphql

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

Show your own designs and their files.graphql

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

Update a creation price.graphql

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