Legacy: Clearbit API Version Change Logs

Last Updated: December 21, 2023

🔍 Please note: this article is for customers on Standard Bundle, Enrichment, or Clearbit Platform plans.

Company API:

• Version 2022-12-15 includes the following change:
  • The Reveal, Discovery and Company APIs now return a new attribute, “trafficRank”:

  "metrics": {
    "alexaUsRank": 25360,
    "alexaGlobalRank": 49044,
    "trafficRank": "high",
    ...
}

2022-04-13

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  the API section. 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.

2020-01-09

Reveal + Company APIs:

• Version 2019-12-19 includes the following change:
  • The key for Ultimate Parent is now camelCased, as follows: 

    "ultimateParent": {
         "domain": "comcast.com"
    }

Person API:

• Version 2019-12-19 combined lookup reflects the new Company API change above.

2019-04-11

Reveal + Company APIs:

• The Reveal and Company APIs now return a new attribute, ultimate_parent:

  "ultimate_parent": {
       "domain": "comcast.com"
  }

2019-01-13

Prospector API:

• Version 2019-01-13 adds advanced support to the query parameter, adding AND/OR/NOT functionality to enable more granular prospect discovery. See the Prospector API query documentation.

2018-11-16

Prospector API:

• Version 2018-11-16 adds the new attribute subRole:

  {
       ...
       "title": "Co-founder, CEO",
       "role": "leadership",
       "subRole": "ceo",
       "seniority": "executive",
       ...
  }

• Allows for role and subRole searching via the existing role parameter

Person API

• Version 2018-11-19 adds the new attribute subRole:

  "employment": {
       ...
       "title": "Co-founder, CEO",
       "role": "leadership",
       "subRole": "ceo",
       "seniority": "executive"
  }

2018-08-15

Prospector API:

• Prospector API 2018-08-15 adds parameters for location searching:

  city, cities[], state, states[], country, countries[]

• Add parameters for pagination:

  page, page_size

• Removes limit parameter.
• Payload changed due to pagination.

  {
    "page": 1,
    "page_size": 5,
    "total": 23,
    "results": [ ........ ]
  }

2018-06-06

Person API:

• Removed aboutme.

2018-03-28

Reveal API:

• Reveal now returns full data sets for educational and governmental institutions.
• type has been added as a top level attribute with ISP, Company, Education, and Government as possible values.
• Responses with type = ISP (internet service provider) will now be returned as successful (status:200). Note: ISP responses will have null domain and company attributes.

2018-02-14

Reveal API:

• Reveal response brought inline with the 2017-09-12 Company API version. Most notably, employeesRange bucket values have changed. 

2018-01-30

Person Combined API:

• Company response within combined lookup will match changes made in `2017-09-12` below.

2017-09-12

Company API:

• Added additional employeesRange buckets
• 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. 

{
  "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.

{
  "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.

{
  "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.