API Version Change Logs

Clearbit API versions

Your API version controls the API and webhook behavior you see (e.g. what properties you see in responses, what parameters you’re permitted to send in requests, etc.). Your version gets set the first time you make an API request. When we change any of our APIs in a backwards-incompatible way, we release a new dated version, but to avoid breaking your code, we don’t change your version until you're ready to upgrade.
To upgrade your APIs to the most current versions visit  your dashboard. You can also override your global version by specifying a specific version in the header of your API request.  Visit the docs for more information.

API changelog

2017-09-12

Company API:

  • Added additional `employeesRange` buckets (see updated ranges)
  • Removed `similarDomains`, `metrics.googleRank`, `site.title`, `site.h1`, `site.metaDescription`, and `site.metaAuthor`

2017-01-02

Company API: The company API no longer returns the url or site.url fields.

2016-08-31

Person Combined API: The combined API will now return company data for companies without a social profile or company name, inline with the 2016-02-26 Company API behaviour.

2016-05-18

Company API: foundedYear has replaced foundedDate. Previously we would have returned null if we were not able to find a full date, this change increases our coverage by allowing us to return data whenever we are able to find a founding year.

2016-02-26

Company API: We no longer require a social profile or company name for a domain to be considered known. This allows us to give better coverage of small business and personal domains.

2016-01-04

Company API: timeZone and utcOffset have been added. We no longer return the angellist object or facebook.likes.

{
    ...
    "timeZone": "America/Los_Angeles",
    "utcOffset": -8,
    ...
}

2015-10-15 

Person API: For consistency with the Company API we've changed the geo attribute to include stateCode and countryCode alongside their full length counterparts. 
Before After
{
  "geo": {
    "city": "San Francisco",
    "state": "CA",
    "country": "US",
    "lat": 37.7749295,
    "lng": -122.4194155
  },
}
			
{
  "geo": {
    "city": "San Francisco",
    "state": "California",
    "stateCode": "CA",
    "country": "United States",
    "countryCode": "US",
    "lat": 37.7749295,
    "lng": -122.4194155
  },
}
			
2015-06-23 
Company API: alexaRank, googleRank, employees, raised and marketCap have been moved to the metrics object in the response.
Before After
{
  "raised": 15000000,
  "employees": 1000,
  "google": {
    "rank": 7
  },
  "alexa": {
    "usRank": 2467,
    "globalRank": 2319,
  },
}
		
{
  "metrics": {
    "raised": 15000000,
    "employees": 1000,
    "googleRank": 7,
    "alexaUsRank": 2467,
    "alexaGlobalRank": 2319,
    "marketCap": null
  },
}
		
2015-06-12
Company API: categories, personal and founders attributes are no longer returned. The new category field returns a normalised sector, industry and sub-industry. A full list of possible category values  can be found here. The previous categories values have been renamed tags. The personal attribute is now simply returned as a value of type.
Before After
{
  "categories": [
    "Web content management system",
    "Website builder",
    "Web hosting service"
  ],
  "personal": false,
  "founders": [],
}
			
{
  "category": {
    "sector": "Information Technology",
    "industryGroup": "Software & Services",
    "industry": "Software",
    "subIndustry": "Application Software"
  },
  "tags": [
    "Web content management system",
    "Website builder",
    "Web hosting service"
  ],
}
			
2015-05-27
Person API: Responses no longer includes full company details. If you require the full company details please use the combined API.
2015-05-11

Person API: Requests to the combined endpoint now return combined webhooks which include both a company and person. The type of the new webhook is person_company.