Node bindings and more

Node bindings and more

October 20, 2014

I'm excited to share another raft of Clearbit features that we've shipped over the last week.

Node bindings

Along with our Ruby bindings for Clearbit, we now have Node bindings. These use a promise based API to asynchronously lookup people and companies via Clearbit.

You can see an example of how to use the API below.

var clearbit = require('clearbit')('API_KEY');
var Person   = clearbit.Person;

Person.find({email: ''})
  .then(function (person) {
    console.log('Name: ',;
  .catch(Person.QueuedError, function (err) {
    // Person lookup is queued
  .catch(Person.NotFoundError, function (err) {
    // Person could not be found
  .catch(function (err) {
    console.error('Failed request', err);

Our docs have been updated with Node examples.

Combined lookup

Many of you were doing two lookups to find person and company information: one based on the person's email and one based on the email's domain name. To save you making two requests to do this we now offer a combined lookup API.

This endpoint expects an email address, and will return an object containing both the person and company (if found).

curl ''

For more information and examples see our documentation.

New attributes

We've added the emailProvider attribute to Company lookup responses. This attribute is a boolean that will be true if the company's domain name is associated with a public email provider such as

We've also added a new attribute geo to Person lookup responses which contains geocoded data based on the person's location.

"geo": {
  "city": "SF",
  "state": "CA",
  "country": "US",
  "lat": 37.7749295,
  "lng": -122.4194155

The location attribute has also been normalized when we can successfully geocode it.


All avatars and company logos are now served by AWS CloudFront. This ensures that you don't get any SSL mixed content errors, and that images are always available.

Next up

That's all for this week, but if you have any suggestions for improving our APIs please do get in touch - all the API features above have come directly from suggestions made by our customers.

How Clearbit reveal delivers reliable B2B IP lookup in the WFH era

Featuresby Clearbit Team on September 12, 2022

Learn how Clearbit Reveal's match rates adapted to the pandemic's abrupt work-from-home change and why it's the smart technological choice in the long run.

Activate Bombora in Clearbit to target in-market prospects

Featuresby Juhi Saha on March 07, 2022

Combining Bombora’s third-party intent data with Clearbit’s company, contact, and website intent data gives you a full-funnel view of the buyer’s journey, so you can identify the accounts that not only fit your Ideal Customer Profile — but are also ready to buy.

Join our newsletter

Engaging stories and exclusive data, designed for our best customers. One useful issue each month.