Clearbit Ruby library
Latest commit 9a3d13a Oct 22, 2016 @robholland robholland Version bump.


A Ruby API client to


Add this line to your application's Gemfile:

gem 'clearbit'

And then execute:

$ bundle

Or install it yourself as:

$ gem install clearbit


First authorize requests by setting the API key found on your account's settings page.

Clearbit.key = ENV['CLEARBIT_KEY']

Then you can lookup people by email address:

result = Clearbit::Enrichment.find(email: '', stream: true)

person  = result.person
company =

Passing the stream option makes the operation blocking - it could hang for 4-5 seconds if we haven't seen the email before. Alternatively you can use our webhook API. If a person or company can't be found, then they'll be nil.

See the documentation for more information.

Company lookup

You can lookup company data by domain name:

company = Clearbit::Enrichment::Company.find(domain: '', stream: true)

If the company can't be found, then nil will be returned.

See the documentation for more information.

Other APIs

For more info on our other APIs (such as the Watchlist or Discover APIs), please see our main documentation.


For rack apps use the Clearbit::Webhook module to wrap deserialization and verify the webhook is from trusted party:

post '/v1/webhooks/clearbit' do
    webhook =
    webhook.type #=> 'person' #=> 'Alex'

    # ...
  rescue Clearbit::Errors::InvalidWebhookSignature => e
    # ...

The global Clearbit.key can be overriden for multi-tenant apps using multiple Clearbit keys like so:

webhook =, 'CLEARBIT_KEY')