Company Enrich Overview

Company Enrichment

FullContact provides you two methods to call our API for company data by leveraging Lookup by Company Domain or Search by Company Name. More data is available through the Lookup by Company Domain, but if the domain is unknown, use our Search by Company Name to find the list of domains that could be related to the Company you are looking for and then call the Lookup by Company Domain with that domain to return the full information about the company.

Lookup by Company Domain

curl -X POST https://api.fullcontact.com/v3/company.enrich \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{"domain":"fullcontact.com"}'
{
  "name": "FullContact, Inc.",
  "location": "1755 Blake Street, Suite 450, Denver, Colorado, United States",
  "twitter": "@fullcontact",
  "linkedin": "https://www.linkedin.com/company/fullcontact-inc-",
  "bio": "FullContact is the ... contacts and be awesome with people.",
  "logo": "https://d2ojpxxtu63wzl.cloudfront.net/stati...8ea9e4d47f5af6c",
  "website": "https://www.fullcontact.com",
  "founded": 2010,
  "employees": 350,
  "locale": "en",
  "category": "Other",
  "details": {
    "entity": {
      "name": "FullContact, Inc",
      "founded": 2010,
      "employees": 350
    },
    "locales": [{
      "code": "en",
      "name": "English"
      }],
    "categories": [{
      "code": "OTHER",
      "name": "Other"
    }],
    "industries": [{
      "type": "SIC",
      "name": "Computer Programming, Data Processing, and Other Computer Related Services",
      "code": "737"
    },
    {
      "type": "NAICS",
      "name": "Data Processing, Hosting, and Related Services",
      "code": "5182"
    }],
    "emails": [{
      "value": "[email protected]",
      "label": "other"
    },
    {
      "value": "[email protected]",
      "label": "sales"
    },
    {
      "value": "[email protected]",
      "label": "work"
    }],
    "phones": [{
      "value": "+1 (720) 475-1292",
      "label": "other"
    },
    {
      "value": "+1 (888) 330-6943",
      "label": "other"
    },
    {
      "value": "(303) 717-0414",
      "label": "other"
    }],
    "profiles": {
      "twitter": {
        "username": "fullcontact",
        "url": "https://twitter.com/fullcontact",
        "service": "twitter",
        "followers": 2873,
        "following": 120
      },
      "linkedin": {
        "username": "fullcontact-inc-",
        "url": "https://www.linkedin.com/company/fullcontact-inc-",
        "service": "linkedin"
      }
    },
    "locations": [{
      "label": "Headquarters",
      "addressLine1": "1755 Blake Street",
      "addressLine2": "Suite 450",
      "city": "Denver",
      "region": "Colorado",
      "regionCode": "CO",
      "postalCode": "80202",
      "country": "United States",
      "countryCode": "USA",
      "formatted": "1755 Blake Street Suite 450 Denver CO 80202"
    }],
      "images": [{
      "url": "https://d2ojpxxtu63wzl.cloudfront.net/...01842912b",
      "label": "logo"
    },
    {
      "url": "https://d2ojpxxtu63wzl.cloudfro...33e489c3aa06c3ac7",
      "label": "other"
    }],
    "urls": [{
      "value": "https://www.fullcontact.com",
      "label": "website"
    },
    {
      "value": "https://www.fullcontact.com/feed",
      "label": "rss"
    },
    {
      "value": "https://www.youtube.com/watch?v=RnltbT0BKMo",
      "label": "youtube"
    }],
    "keywords": [
      "CRM",
      "Contact Management",
      "Developer APIs",
      "Information Services",
      "Social Media"
    ],
    "traffic": {
      "countryRank": {
        "global": {
          "rank": 40093,
          "name": "Global"
        },
        "us": {
          "rank": 15545,
          "name": "United States"
        }
      },
      "localeRank": {
        "in": {
          "rank": 29313,
          "name": "India"
        },
        "gb": {
          "rank": 18772,
          "name": "United Kingdom"
        },
        "us": {
          "rank": 15545,
          "name": "United States"
        }
      }
    },
    "keyPeople": [{
      "fullName": "Bart Lorang",
      "title": "CEO",
      "avatar": "https://d2ojpxxtu63wzl.cl...bf84a60c5926701b4c5033",
    },
    {
      "fullName": "Scott Brave",
      "title": "CTO",
      "avatar": "https://d2ojpxxtu63wzl.cloudf....49ec3bcbb401c47",
    }]
  },
  "dataAddOns": [{
    "id": "keypeople",
    "name": "Key People",
    "enabled": true,
    "applied": true,
    "description": "People of interest at this company",
    "docLink": "https://fullcontact../api-next-slate/#keypeople"
  }],
  "updated": "2017-11-01"
}

Retrieve information about a company by supplying the domain name. This method supports additional data over the Company Search by Name.

This endpoint supports the use of webhooks. To use webhooks, include webhookUrl as a property inside
of the Company request object. Click here to learn more about Webhooks in the FullContact API.

Request Properties
domain stringQueryable The domain name of the company to lookup.
webhookUrl Webhook URLOptional An optional parameter on the request body containing a URL to an endpoint on your service that will accept a posted json response of an enrichment result.
Response Properties
name stringThe name of the company.
location stringThe location or address of the company.
twitter stringThe URL to the twitter profile associated with the company.
linkedin stringThe URL to the LinkedIn profile associated with the company.
bio stringThe company's bio.
logo stringURL to the logo or image for the company.
website stringURL to the company's website
founded integerThe year the company was founded.
employees integerAn approximate number of employees with the company.
locale stringThe locale of the company.
category stringThe category of the company. Possible values are Adult, Email Provider, Education, SMS, or Other.
details.locales[n].code stringThe code for each locale of the company.
details.locales[n].name stringThe displayable name for each locale of the company.
details.categories[n].code stringThe code for each category of the company. Possible calues are Adult, Email Provider, Education, SMS, or Other.
details.categories[n].name stringThe displayable name for each category of the company.
details.industries[n].type stringThe type of industry classification/code being used. Possible values are NAICS or SIC.
details.industries[n].name stringThe name for each of the industry classifications of the company.
details.industries[n].code stringThe industry code for each of the industry classifications of the company. FullContact's Company API returns the latest NAICS/SIC standard (2017) codes.
details.emails[n].value stringAn email address associated with the company.
details.emails[n].label stringThe type or label of the email address, with values such as sales, work, and other.
details.phones[n].value stringA phone number associated with the company.
details.phones[n].label stringThe type or label of the phone number, with values such as sales, work, and other.
details.profiles.{platform}.username stringDisplayable username of the profile.
details.profiles.{platform}.userid stringUser ID associated with the profile.
details.profiles.{platform}.url stringURL to the profile on the social platform.
details.profiles.{platform}.bio stringBio of the profile form the social platform.
details.profiles.{platform}.service stringName of the social platform.
details.profiles.{platform}.followers integerNumber of follows of the profile, if applicable.
details.profiles.{platform}.following integerNumber of profiles or topics the user is following, if applicable.
details.locations[n].label stringThe label for each company location.
details.locations[n].addressLine1 stringThe first address line for each location.
details.locations[n].addressLine2 stringThe second address line for each location.
details.locations[n].city stringThe city of each location.
details.locations[n].region stringThe region of each location. This is often the state or province.
details.locations[n].regionCode stringThe region code of each location.
details.locations[n].postalCode stringThe postal or ZIP code for each location.
details.locations[n].country stringThe country for each location.
details.locations[n].countryCode stringThe country code for each location.
details.locations[n].formatted stringA single, formatted string representation of the location.
details.images[n].url stringThe URL for each photo or logo of the company.
details.images[n].label stringThe name or type of image for the company.
details.urls[n].value stringThe URL or website associated with the company.
details.urls[n].label stringThe type or name of website.
details.keywords arrayAn array of keywords commonly associated with the company.
details.traffic.countryRank.{region}.rank integerThe company's web traffic rank for the given region.
details.traffic.countryRank.{region}.name stringThe name of the region for the traffic rank.
details.traffic.localeRank.{locale}.rank integerThe company's web traffic rank for the given locale.
details.traffic.localeRank.{locale}.name stringThe name of the locale for the traffic rank.

Search by Company Name

curl -X POST https://api.fullcontact.com/v3/company.search \
-H "Authorization: Bearer {Your API Key}" \
-H "Content-Type: application/json" \
-d '{"companyName":"fullcontact"}'
{
    "lookupDomain": "fullcontact.com",
    "orgName": "FullContact Inc.",
    "logo": "https://d2ojpxxtu63wzl.cloudfront.net/static/91a060eb8afdbd9c89fe23ed3a658a84_c1315c9e876cb92fee969e95c92e5fc5930d1b8f5d563d34b5e6fc4c58d8fa7e_150x150",
    "location": {
      "locality": "Denver",
      "region": {
        "name": "Colorado",
        "code": "CO"
      },
      "country": {
        "name": "United States",
        "code": "US"
      }
    }
  },
  {
    "lookupDomain": "brewster.com",
    "orgName": "FullContact Inc.",
    "logo": "https://d2ojpxxtu63wzl.cloudfront.net/static/d0c63e9b9d53ce25e7a3f48da3beb9d2_d66ec972fd330acf55d5b5c8ad06a787909f99fc2166363abd5b56d458ba6e1e_150x150",
    "location": {
      "locality": "Denver",
      "region": {
        "name": "Colorado",
        "code": "CO"
      },
      "country": {
        "name": "United States",
        "code": "US"
      }
    }
  }
]

Use this method to request more information about a specific company by name.

Request Properties
companyName RequiredThe name of the company to search for. Common words like "Inc." will be ignored.
sort Optional

Controls how results will be sorted. There are three options:

  • traffic(default): Sort high-traffic domains to the top
  • relevance: Sort by how closely the company name matches
  • employees: Sort companies with many employees to the top
location OptionalIf supplied, only companies matching given location will be returned. The location is a general location where one can include any combination of locality, region or country as input. For example, "location": "Denver, CO"
locality OptionalIf supplied, only companies matching given locality/city will be returned. For example, "locality": "New York" or locality=Dallas
region OptionalIf supplied, only companies matching given region/state will be returned. For example, "region": "New York" or region=NY
country OptionalIf supplied, only companies matching given country will be returned. For example, "country": "United States" or "country": "US"
Response Properties
lookupDomain stringThe domain of the company. Use this string as the input to return more information about the comapny through the Lookup by Company Domain method.
orgName stringThe name of the company.
logo stringURL to the logo or image for the company.
location.locality stringThe locatlity of the comapny.
location.region.name stringThe name of the region.
location.region.code stringThe code of the region.
location.country.name stringThe name of the country.
location.country.code stringThe code of the country.

Did this page help you?