Ruby and Clojure client libraries for the Helioid API
Sunday, November 10, 2013We recently released a Helioid API that returns categorized search results.
To retrieve JSON results for a
query like “data
analytics” simple append
“?format=json
” to the URL, i.e.
[http://www.helioid.com/searches/q/data+analytics?format=json] (http://www.helioid.com/searches/q/data+analytics?format=json)
To make this easier to use we have released open source Ruby and Clojure client libraries. Install the Ruby library with:
gem install heliapi
then load and fetch categories using:
require 'heliapi'
results = Heliapi.new.web('ruby apis')
results['categories'].keys
which returns:
=> ['Developer',
'Access',
'Provides',
'Rails',
'Building',
'Install',
'Google Api Ruby',
'Ruby Client'
]
To install the Clojure library add heliapi
to your Leiningen project.clj
file:
[heliapi "0.0.1"]
then load and fetch categories with:
(:require [heliapi.core :as helioid])
(map #(:name %)
(:categories (helioid/web "helioid")))
which returns the results as:
=> ("search refinement"
"search engine"
"results"
"helioid choroiditis"
"intranuclear helioid inclusions"
"intranuclear helioid"
"new"
"helioid search")
We will add features to the API and client libraries as requested. We will also make libraries for other languages as requested.