Clearbit integration

  1. What is Clearbit Enrichment?
  2. What is Clearbit Reveal?
  3. How to use it in Plainflow’s workflow?
  4. How to integrate with Clearbit?
  5. Usecases with Clearbit

What is Clearbit Enrichment?

Clearbit Enrichment is a data API that lets you enrich your person and company records with social, demographic, and firmographic data.

All you need is an email address, and Clearbit will provide a range of more than 85 data points about the user like company size, technology used, job title, or location.

At moment we only support Clearbit Enrichment. Let us know here if you need other Clearbit’s products? (ie. Clearbit Reveal, Clearbit Prospector)

How to use it in Plainflow’s workflow?

You can enrich a profile in your workflow anywhere, anytime by adding the action “Enrich user profile” from the Clearbit integration in the workflow editor.

The enriched information can be used to create more precise user segments (e.g. segment all the active users who work in a company with more than 1,000 employees) and to design personalized customer journeys with workflows (e.g. send a personalized welcome email to your new users based on their job role).

shadow-clearbit-action

Data points about Person provided by Clearbit 👨 👧

You can use all these information to better model your customer journeys.

👉 Check out on Clearbit the full documentation for Enrichment API

Person AttributesTypeDescription 
idstringInternal ID 
name.givenNamestringFirst name of person (if found) 
name.familyNamestringLast name of person (if found) 
name.fullNamestringFull formatted name of person. Sometimes this will be present even if the givenName or familyName aren’t available 
genderstringmale or female 
locationstringThe most accurate location we have 
timeZonestringThe timezone for the person’s location 
utcOffsetintegerThe offset from UTC in hours in the person’s location 
geo.citystringNormalized city based on location 
geo.statestringNormalized state based on location 
geo.countrystringNormalized two letter country code based on location 
geo.latfloatGeneral latitude based on location 
geo.lngfloatGeneral longitude based on location 
biostringThe most accurate bio we have 
sitestringThe person’s website 
avatarstringThe best avatar url we have 
employment.namestringCompany name 
employment.titlestringTitle at Company 
employment.rolestringRole at Company 
employment.senioritystringSeniority at Company 
employment.domainstringCompany domain 
facebook.handlestringFacebook ID or screen name 
github.handlestringGitHub handle 
github.idintegerGitHub ID 
github.avatarstringGitHub avatar 
github.companystringGitHub company 
github.blogstringGitHub blog url 
github.followersstringCount of GitHub followers 
github.followingstringCount of GitHub following 
twitter.handlestringTwitter screen name 
twitter.idintegerTwitter ID 
twitter.followersintegerCount of Twitter followers 
twitter.followingintegerCount of Twitter friends 
twitter.locationstringTwitter location 
twitter.sitestringTwitter site 
twitter.statusesintegerTweet count 
twitter.favoritesintegerFavorite count 
twitter.avatarstringHTTP Twitter avatar 
linkedin.handlestringLinkedIn url 
googleplus.handlestringGoogle Plus handle 
aboutme.handlestringabout.me handle 
aboutme.biostringabout.me bio 
aboutme.avatarstringabout.me avatar URL 
gravatar.handlestringGravatar handle 
gravatar.urlsarrayArray of URLs from Gravatar 
gravatar.avatarstringGravatar main avatar url. 
gravatar.avatarsstringArray of objects containing a avatar url, and a type 
fuzzybooleanIndicating whether or not the lookup is a fuzzy or exact search 
emailProviderbooleanis the email domain associated with a free email provider 
indexedAtstring dateThe time at which we indexed this data 

The information above will be saved in the profile section for every new enrichd user.

Data points about Company provided by Clearbit 🏢

You can use all the data points below to better design and model your customer journeys.

👉 Check out on Clearbit the full documentation for Enrichment API

Company AttributesTypeDescriptionHelp docs
idstringInternal ID 
namestringName of company 
legalNamestringLegal name of company 
domainstringDomain of company’s website 
domainAliasesarrayList of domains also used by the company 
site.phoneNumbersarrayList of phone numbers mentioned on the company’s website 
site.emailAddressesarrayList of email addresses mentioned on the company’s website 
tagsarrayList of market categories
View full list
 
category.sectorstringBroad sector
View full list
 
category.industryGroupstringIndustry group
View full list
 
category.industrystringIndustry
View full list
 
category.subIndustrystringSub industry
View full list
 
category.sicCodestringTwo digit category SIC code 
category.naicsCodestringTwo digit category NAICS code 
descriptionstringDescription of the company 
foundedYearintegerYear company was founded 
locationstringAddress of company 
timeZonestringThe timezone for the company’s location 
utcOffsetintegerThe offset from UTC in hours in the company’s location 
geo.streetNumberstringHeadquarters street number 
geo.streetNamestringHeadquarters street name 
geo.subPremisestringHeadquarters suite number 
geo.citystringHeadquarters city name 
geo.statestringHeadquarters state name 
geo.stateCodestringHeadquarters two character state code 
geo.postalCodestringHeadquarters postal/zip code 
geo.countrystringHeadquarters country name 
geo.countryCodestringHeadquarters two character country code 
geo.latfloatHeadquarters latitude 
geo.lngfloatHeadquarters longitude 
identifiers.usEINstringUS Employer Identification Number 
metrics.raisedintegerTotal amount raised 
metrics.alexaUsRankintegerAlexa’s US site rank 
metrics.alexaGlobalRankintegerAlexa’s global site rank 
metrics.employeesintegerAmount of employees 
metrics.employeesRangestringEmployees range
View full list
 
metrics.marketCapintegerMarket Cap 
metrics.annualRevenueintegerAnnual Revenue (public companies only) 
metrics.fiscalYearEndintegerMonth that the fiscal year ends (1-indexed) 
facebook.handlestringCompany’s Facebook ID 
linkedin.handlestringCompany’s Linkedin URL 
twitter.handlestringTwitter screen name 
twitter.idintegerTwitter ID 
twitter.biostringTwitter Bio 
twitter.followersintegerCount of Twitter followers 
twitter.followingintegerCount of Twitter friends 
twitter.locationstringTwitter location 
twitter.sitestringTwitter site 
twitter.avatarstringHTTP Twitter avatar 
crunchbase.handlestringCrunchbase handle 
logostringSRC of company logo 
emailProviderbooleanis the domain associated with a free email provider (i.e. Gmail)? 
typestringThe company’s type, eithereducation,government,nonprofit,private,public, orpersonal. 
phonestringInternational headquarters phone number 
techarrayArray of technology tags 
parent.domainstringThe domain of the parent company (if any) 
indexedAtstring dateThe time at which we indexed this data 

The information above will be saved in the profile section for every new enrichd user.

What is Clearbit Reveal?

Clearbit Reveal it’s the easiest way to match a site visitor’s IP address with

Clearbit Reveal provides an API that takes an IP address, and returns the with full company profile — complete with industry, employee count, funding details, associated with that IP.

This finds lots of relevant use cases for de-anonymizing incoming traffic on your website.

Here are the attributes that Clearbit Reveal API will return:

AttributesTypeDescriptionHelp docs
ipstringIP address that was looked up 
fuzzybooleanFalse if the company has their own dedicated ASN block, otherwise true. 
domainstringThe matched company domain 
typestringThe type of result (company, education, government, isp) 
companyobjectA full company object 

Note: When using the Clearbit Reveal action, Plainflow will automatically pass Clearbit the IP address tied to the latest pageview.

How to integrate with Clearbit

1. Create a Clearbit account

If you are already using Clearbit you can skip this step. If you’re not already using it, you need to create a Clearbit account.

If you start with a Clearbit free plan you only have 50 API calls. We recommend you to check out Clearbit Pricing Plans to learn more.

2. Connect Clearbit with Plainflow

Connecting Plainflow with Clearbit is easy: simply head to the Clearbit integration, click Enable Clearbit and authorize access in the window that will pop up.

alt shadow-clearbit-oauth

Usecases with Clearbit

Plainflow gives you the flexibility to call a Clearbit API exactly when you need it.

Here are some use cases:


Not using Plainflow yet? Get your free account here. 👈