gem install fullcontacter

require "rubygems"
require "fullcontact"

# This could go in an initializer
FullContact.configure do |config|
  config.api_key = "fullcontact_api_key_goes_here"
end

# Get information about a email address
person = FullContact.lookup_by_email('[email protected]')
  
# Get information about a twitter handle
person2 = FullContact.lookup_by_twitter('prafulla')

# Get person's family_name
puts person.contact_info.family_name

# Authenticate a user
FullContact.authenticate( { :username => '[email protected]', :password => 'test' } )

# Authentication is requred for all methods under the 'Contact' and 'ContactList' categories
FullContact.get_contact_lists