Response Parameters Details

Get details of a couple of important output response objects.

We'll cover the following

The person object

The person object has the following attributes:

Name

Type

Description

id

string

This is the internal ID associated with the person on Clearbit.

name.givenName

string

This is the first name of the person if found.

name.familyName

string

This is the last name of the person if found.

name.fullName

string

This is the fully formatted name of the person.

location

string

This is the most accurate location of the person Clearbit could get.

timeZone

string

This is the timezone of the person's location.

utcOffset

integer

This is the offset from UTC in hours in the person’s location.

geo.city

string

This is the city normalized based on the person's location.

geo.state

string

This is the state normalized based on the person's location.

geo.country

string

This is the two-letter country code normalized based on the person's location.

geo.lat

float

This is the general latitude based on the person's location.

geo.lng

float

This is the general longitude based on the person's location.

bio

string

This is the most accurate bio of the person Clearbit could get.

site

string

This is the website of the person if any.

avatar

string

This is the URL for the avatar of the person, the best Clearbit could get.

employment.name

string

This is the name of the company for which the person works.

employment.title

string

This is the title of the person at the company.

employment.role

string

This is the role of the person at the company.

employment.subRole

string

This is the sub-role of the person at the company.

employment.seniority

string

This is the seniority level of the person at the company.

employment.domain

string

This is the domain of the company.

facebook.handle

string

This is the person's Facebook ID or screen name.

github.handle

string

This is the person's GitHub handle.

github.id

integer

This is the person's GitHub ID.

github.avatar

string

This is the person's avatar on GitHub.

github.company

string

This is the person's company on GitHub.

github.blog

string

This is the URL of the person's blog.

github.followers

string

This is the number of followers this person has on GitHub.

github.following

string

This is the number of people following this person on GitHub.

twitter.handle

string

This is the person's screen name on Twitter.

twitter.id

integer

This is the person's Twitter ID.

twitter.followers

integer

This is the number of followers this person has on Twitter.

twitter.following

integer

This is the number of people following this person on Twitter.

twitter.location

string

This is the location of the person as per Twitter.

twitter.site

string

This is the person's website given on Twitter.

twitter.statuses

integer

This is the total number of tweets this person has.

twitter.favorites

integer

This is the number of favorites this person has on Twitter.

twitter.avatar

string

This is the URL of a person's avatar on Twitter.

linkedin.handle

string

This is the LinkedIn URL of this person.

googleplus.handle

string

This is the person's Google Plus handle.

gravatar.handle

string

This is the person's Gravatar handle.

gravatar.urls

array

This is an array of URLs from the person's Gravatar handle.

gravatar.avatar

string

This is the person's main avatar URL on Gravatar.

gravatar.avatars

string

This is an array of objects containing the avatar URLs and a type, thumbnail.

fuzzy

boolean

This is the flag that shows whether the lookup is a vague or an exact search.

emailProvider

boolean

This is the flag that shows whether the email domain is associated with a free email provider, Gmail or not.

indexedAt

string date

This is the time at which Clearbit indexed this data.

The company object

The company object has the following attributes:

Name

Type

Description

id

string

This is the internal ID associated with the company on Clearbit.

name

string

This is the name of the company.

legalName

string

This is the legal name of the company.

domain

string

This is the domain of the company's website.

domainAliases

array

This is an array that contains all the domains used by this company.

site.phoneNumbers

array

This is an array that contains all the phone numbers mentioned on the company's website.

site.emailAddresses

array

This is an array that contains all the email addresses mentioned on the company's website.

tags

array

This is an array that contains all the market categories applicable to this company. Clearbit has its own set of market categories. "Accounting," "Biotechnology," "Cosmetics," and "Fine Art" are a few examples.

category.sector

string

This is the broad sector of the company. Clearbit has its own set of market sectors. For example, "Information Technology" is the sector to which a company belongs.

category.industryGroup

string

This is the industry group to which the company belongs. Clearbit has its own set of industry groups. For example, "Software and Services."

category.industry

string

This is the industry to which the company belongs. Clearbit has its own set of industries. For example, "Internet Software & Services."

category.subIndustry

string

This is the sub-industry to which the company belongs. Clearbit has its own set of sub-industries. For example, "Internet Software & Services."

category.sicCode

string

This is a two-digit category SIC code. The SIC (Standard International Code) is used to classify industries. For example, "47."

category.naicsCode

string

This is the two-digit category NAICS code. The NAICS (North American Industry Classification System) is used to classify business establishments. For example, "51."

description

string

This is the description of the company. For example, "Get a taxi, private car or rideshare from your mobile phone..." is the description for the company "Uber."

foundedYear

integer

This is the year when the company was established.

location

string

This is the address of the company.

timeZone

string

This is the timezone for the company’s location.

utcOffset

integer

This is the offset from UTC in hours in the company’s location.

geo.streetNumber

string

This is the street number of the company's headquarters.

geo.streetName

string

This is the street name of the company's headquarters.

geo.subPremise

string

This is the suite number of the company's headquarters, if any.

geo.city

string

This is the name of the city where we have the company's headquarters.

geo.state

string

This is the name of the state where we have the company's headquarters.

geo.stateCode

string

This is the two-character state code of the company's headquarters.

geo.postalCode

string

This is the postal/zip code of the company's headquarters.

geo.country

string

This is the name of the country where we have the company's headquarters.

geo.countryCode

string

This is the two-character country code of the company's headquarters.

geo.lat

float

This is the latitude position of the company's headquarters as per the map.

geo.lng

float

This is the longitude position of the company's headquarters as per the map.

identifiers.usEIN

string

This is the US Employer Identification Number (USEIN) of the company. For example, "452647441."

metrics.raised

integer

This is the total amount raised by the company (up till now).

metrics.alexaUsRank

integer

This is Alexa’s US site rank of the company.

metrics.alexaGlobalRank

integer

This is Alexa’s global site rank of the company.

metrics.employees

integer

This is the number of employees the company has.

metrics.employeesRange

string

This is the range of employees a company can have.

metrics.marketCap

integer

This is the market cap of the company, that is, the market value of a publicly traded company's outstanding shares, if any. 

metrics.annualRevenue

integer

This is the annual revenue earned by the company (public companies only).

metrics.estimatedAnnualRevenue

string

This is the estimated annual revenue range of the company.

metrics.fiscalYearEnd

integer

This is the month where the fiscal year ends for the company.

facebook.handle

string

This is the Facebook ID of the company.

linkedin.handle

string

This is the Linkedin URL of the company.

twitter.handle

string

This is the name this company has on Twitter.

twitter.id

integer

This is the Twitter ID of the company.

twitter.bio

string

This is the company's Twitter bio.

twitter.followers

integer

This is the number of Twitter followers a company has.

twitter.following

integer

This is the number of people following this company on Twitter.

twitter.location

string

This is the location of the company, as per Twitter.

twitter.site

string

This is the company's website given on Twitter.

twitter.avatar

string

This is the URL of a company's avatar on Twitter.

crunchbase.handle

string

This is the company's Crunchbase handle.

logo

string

This is the src of the company's logo.

emailProvider

boolean

This is the flag that shows whether the email domain is associated with a free email provider, that is, Gmail or not.

type

string

This is the type of company. Possible values include either "education," "government," "nonprofit," "private," "public," or "personal."

phone

string

This is the phone number of the company's international headquarters.

tech

array

This is an array that contains all the technology tags associated with the company.

techCategories

array

This is an array that contains all the technology categories the company uses.

parent.domain

string

This is the domain of the parent company if any.

ultimateParent.domain

string

This is the domain of the ultimate parent company, if any.

indexedAt

string date

This is the time at which Clearbit indexed this data.