Incandescent

$ bundle

$ gem install incandescent

client = Client.new(uid, api_key)

# The following line can be called multiple times to search multiple images
client.add_image_url('http://example.com/image.jpg')

# We have to separate the search initiation and results retrieval because
# retrieval may take several attempts (and a minutes-long lag) before completing.
client.initiate_search
hosts = client.get_results

hosts.each do |host|
  host.name   # pinterest.com

  # Page is not a great name for each of these result objects, but it matches the API format.
  host.pages.each do |page|
    page.page          # http://thief.example.com/my-stolen-photos.html
    page.source        # google OR bing OR <etc>
    page.date          # Unix timestamp
    page.usage_image   # URL for the discovered image
    page.usage_height  # Pixel height of discovered image
    page.usage_width   # Pixel width of discovered image
    page.image         # URL for the original image to search with
    page.iid           # Incandescent ID for the original image
  end
end