Person & Company lookup

Person & Company lookup

August 18, 2014

I'm excited to announce the launch of two new APIs into our private beta:

  • Person API:
    Find all the social information associated with an email address,
    such as name, Twitter handle, Facebook handle and LinkedIn handles.

  • Company API:
    Find all the company information associated with a domain name,
    such as name, amount raised, employee count, and Twitter handle.

Let's dive straight in and see what a Person lookup request looks like.

Looking up an email address

Our API is based on REST and JSON. Fetching information is as simple as running a curl command, although we also provide bindings in your language of choice. Let's look up my personal email address:

curl '' \
        -u APIKEY:

    "id": "d54c54ad-40be-4305-8a34-0ab44710b90d",
    "name": {
      "fullName": "Alex MacCaw",
      "givenName": "Alex",
      "familyName": "MacCaw"
    "email": "",
    "location": "San Francisco",
    "bio": "Ruby Dev",
    "twitter": {
      "handle": "maccaw",
      "followers": 14993,
      "following": 1645
    "linkedin": {
      "handle": "pub/alex-maccaw/78/929/ab5"
    "github": {
      "handle": "maccman"
    "facebook": {
      "handle": "amaccaw"

Notice all you need provide is an email address - APIHub returns all the social profiles and data we can find linked to the person behind that email address. You can find a full list of returned attributes in our documentation.

Practical uses

Both APIs have far reaching uses from customer analytics and sales to fraud prevention. For example:

  • Run an email list through the Person API finding high value subscribers (say with a lot of Twitter followers).
  • Run up every sign up to your site through both the Person and Company APIs, alerting you to high value clients and also giving you some context about your customers.
  • Make sure an email address has some social context behind it to reduce credit card fraud.

Data sources

All this data is obtained from running a huge cluster of machines indexing the web--essentially building a search engine that's specific to people and companies rather than web pages.

Next steps

These two APIs are just the start of many. Our mission is
to give our customers the kind of data APIs a modern business needs,
from customer analysis, geolocation and fraud prevention to background
checks and address verification.

We want to build awesome data APIs so you can focus on building great products.

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.