Skip to content
This repository

A Ruby wrapper for the FullContact API

branch: master

FullContact Ruby Gem

A Ruby wrapper for the FullContact API


0.6.0 - Removal of timeoutSeconds parameter. This parameter is automatically stripped from your request if included.


gem install fullcontact


Usage Examples

require "rubygems"
require "fullcontact"

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

# Get information about a email address
person = FullContact.person(email: "")

# Get information about a twitter handle
person2 = FullContact.person(twitter: "brawest")

# Get information about a facebook username
person3 = FullContact.person(facebookUsername: "bart.lorang")

# Get information from a phone number
person4 = FullContact.person(phone:13037170414)

# Get information about a twitter and ensure a 30s socket open timeout and a 15s socket read timeout
# Can throw a Faraday::Error::TimeoutError if timeouts are exceeded
person3 = FullContact.person({:twitter => "brawest"}, {:request => {:timeout => 15, :open_timeout => 30}})

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


  • Michael Rose (Xorlev)
  • Ian Fisher (i-taptera)
  • Scott Watermasysk (scottwater)
  • Stefano Fontanelli (stefanofontanelli)


Copyright (c) 2013 FullContact, Brandon West

See LICENSE for details.

Something went wrong with that request. Please try again.