Output Response - Company Enrichment API

Detailed information on the output response that the Company Enrichment API returns

Response Data Structure

Abridged Response Data Structure

Here is an example response from the Company Enrichment API:

{
    "status": 200,
    "id": "google",
    "name": "google",
     "founded": "1998",
     ...
}

Full Example Response

Full Output Response (click to expand)
{
  "status": 200,
  "name": "google",
  "size": "10001+",
  "employee_count": 260979,
  "id": "google",
  "founded": 1998,
  "industry": "internet",
  "location": {
    "name": "mountain view, california, united states",
    "locality": "mountain view",
    "region": "california",
    "metro": "san francisco, california",
    "country": "united states",
    "continent": "north america",
    "street_address": "1600 amphitheatre parkway",
    "address_line_2": null,
    "postal_code": "94043",
    "geo": null
  },
  "linkedin_id": "1441",
  "linkedin_url": "linkedin.com/company/google",
  "facebook_url": "facebook.com/google",
  "twitter_url": "twitter.com/google",
  "profiles": [
    "linkedin.com/company/google",
    "linkedin.com/company/1441",
    "facebook.com/google",
    "twitter.com/google",
    "crunchbase.com/organization/google"
  ],
  "website": "google.com",
  "ticker": "GOOGL",
  "type": "public",
  "summary": "google\u2019s mission is to organize the world\u2018s information and make it universally accessible and useful. since our founding in 1998, google has grown by leaps and bounds. from offering search in a single language we now offer dozens of products and services\u2014including various forms of advertising and web applications for all kinds of tasks\u2014in scores of languages. and starting from two computer science students in a university dorm room, we now have thousands of employees and offices around the world. a lot has changed since the first google search engine appeared. but some things haven\u2019t changed: our dedication to our users and our belief in the possibilities of the internet itself.",
  "tags": [
    "online video",
    "artificial intelligence",
    "mobile",
    "android",
    "cloud",
    "machine learning",
    "virtual reality",
    "apps",
    "software",
    "ads"
  ],
  "headline": null,
  "alternative_names": [
    "google inc.",
    "google, social marketing tools",
    "google, inc.",
    "google inc",
    "google, inc",
    "google summer of code",
    "google maps",
    "google ireland",
    "wildfire, a division of google",
    "wildfire interactive, inc."
  ],
  "alternative_domains": [
    "googlevideo.com",
    "google.nl",
    "google.pt",
    "gkecnapps.cn",
    "youtube.com",
    "youtu.be",
    "youtubeeducation.com",
    "gstatic.cn",
    "youtubekids.com",
    "googleadapis.com"
  ],
  "affiliated_profiles": [
    "youtube",
    "google-cloud",
    "think-with-google",
    "google-ads-",
    "googleworkspace",
    "google-analytics",
    "googlemarketingplatform",
    "google-ad-manager",
    "grow-with-google",
    "google-cloud-partners",
    "google-for-startups",
    "google-small-business",
    "x",
    "google-partners",
    "rework-with-google",
    "googleplaydev",
    "googleadmob",
    "google-user-research.",
    "google-news-initiative",
    "adometry"
  ],
  "likelihood": 4
}

Response Fields

data.*

TypeDescription
ObjectThe matched profile in the format described in our Company Schema.

The data object contains the entire PDL profile for the company that matches the Enrichment API request. Any profile field that we do not have data for will have a null value.


status

TypeDescription
IntegerThe API response code.

likelihood

TypeDescription
IntegerHow confident we are that the returned profile is the same as the company you requested. Will be an integer between 1 and 10.

You can control the minimum likelihood score that a response must have in order to count as a match by setting the min_likelihood parameter in the API request.

We assign every match that the API finds during the enrichment process a likelihood score, to represent our confidence that the profile returned is the same as the profile requested. A score of 1 represents a very low confidence level while a score of 10 represents the highest degree of confidence. The likelihood score is logarithmic, so a response that returns a likelihood score of 2 will have roughly a 10-30% chance of being the person requested.

For example, enriching "John Smith, Inc." in "New York" is too vague for us to confidently say which of our profiles is the exact John Smith Inc. that you requested. However, if you were to attach a website, stock ticker, and street address to the request and they matched our data, we would be highly confident that we are returning the correct John Smith Inc.

matched

TypeDescription
Array (String)Every query input from the request that matched this profile.

IMPORTANT: This field will only be included in the response if the include_if_matched flag is set to true.

See the include_if_matched input parameter for more details.