Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Scala bindings for Gilt API
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Aurum, a Gilt Scala API


Aurum is a simple scala client binding for Gilt's API. It is designed to be simple to use, so that developers don't need to worry about making the correct requests or interpreting the results of those requests, and can instead get right to developing their awesome apps!

To Use

Each object (Sale, Product, Image, SKU) directly represents the contents of each respective "response" subsection listed on this page.


val client = new GiltClient(apikey) //where apikey is already defined


Get List of All Active Sales

val list_of_sales =

Get List of All Active Sales Within A Store

val list_of_sales ="women") //argument should be a valid store

Get List of Upcoming Sales

val list_of_sales = client.upcoming

Get List of Upcoming Sales Within A Store

val list_of_sales = client.upcoming("men") //argument should be a valid store

Get Details of a Sale

val details = client.detail("kids", sale_key) //where sale_key is valid and previously defined


Get Details of a Product Using a Product ID

val details = client.detail(product_id) //where product_id is valid and previously defined

Get Details of a Product Using a valid URL

Part of the response from a Sale is a list of URLs of valid API calls for getting product details. These URLs can be used directly to get the details of any Product in a Sale.

val details = client.detailFromURL(url) //where url is part of a valid response from a Sale

Contributing to Aurum

  • Check out the latest master to make sure the feature hasn’t been implemented or the bug hasn’t been fixed yet
  • Check out the issue tracker to make sure someone already hasn’t requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don’t break it in a future version unintentionally.


Tests assume that you have a Secret.scala object in the src/test/scala directory. That object should look like:

object Secret {
  val password = "<YOUR GILT API KEY GOES HERE>"

Tests can be run with sbt test.


This client binding was written by Moses Nakamura and Vivek Bhagwat

Something went wrong with that request. Please try again.