artifacia

Artifacia Ruby Client

This ruby client is a simple wrapper around our powerful Visual Discovery API.

The wrapper allows you to create your own index of images on which you would like to enhance the product discovery experiences. It also allows you to get various types of recommendations which are listed below.

• Visual Recommendation
• Cross Product Recommendation
• Personalized Recommendation

Installation

To install the package you can follow the steps:-

[sudo] gem install artifacia

Getting Started

The API is really easy and simple to use. First you need to visit this page and request for username and password. Using that credentials you can create your constructor and get stated.

require 'artifacia'
api_key = <api_key>
client = Client.new(api_key)

Creating your index

The first step is to create a index of the items that you would like to store in our databases to perform search against. If you don't have data ready right now you can quickly get started with our sample data. Once the data is stored and indexed we will inform you shortly.

sample_data = File.read("sample_data.json")
data_indexing_response = client.upload_item_data(sample_data)
puts data_indexing_response

Performing Visual Recommendation

Once you receive a notification form us about the status of the indexed data, you are ready to search. You can search for a product ID indexed in the sample data you inserted/uploaded. And also you can specify the number to results to be returned as well as you can set attribute if you want to prioritize the result on the basis of tags like color, material, pattern etc as given below.

sample_prod_id = 2761
num = 4
filters = {"color" => 1, "pattern" => 1}
query_response = client.get_visual_recommendation(sample_prod_id, num, filters)
puts query_response