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.

Introducing Clearbit Traffic Rank

Featuresby Alejandra Cabrera on February 01, 2023

Today we're excited to introduce Clearbit Traffic Rank, an aggregated metric designed to replace Alexa Rank. Read more.

Company Name to Domain API

Featuresby Alex MacCaw on November 29, 2022

[Updated] Originally posted on January 2, 2021 Clearbit's Name to Domain API takes a company name and returns their website domain and logo. It's free, up to 50k requests a month. The only requirement is a free Clearbit account. Sign up for your free Clearbit account here. [] At Clearbit, we believe that domain name is the new company identifier, and require a domain name to kick off our enrichment process. Unlike company names, there can only be one domain name. T

Join our newsletter

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