The People Data Labs Developer Hub

Welcome to the People Data Labs developer hub. You'll find comprehensive guides and documentation to help you start working with People Data Labs as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Release Notes

Company Enrichment API

The endpoint for the company enrichment api is https://api.peopledatalabs.com/v5/company/enrich

Company Enrichment API Access and Billing

When a matching company is returned, the HTTP Response code will be 200, and when no matching company is found or returned, the HTTP Response code will be a 404. We charge per match.

Usage

PDL's company enrichment API is designed to provide a one to one company match. The company data provided by this endpoint includes all the fields in our Company Schema. These fields are beyond what we provide as part of our Person Data or in the Cleaner APIs.

Requests

See Authentication and Requests to see possible ways to input requests. We recommend using the body of your request and will do so in the examples below.

Rate Limiting

The standard rate limit is 10/min for testing purposes and 1000/min for paying customers.

Input Parameters

Data points on the queried company are added as key/value pairs to the query string of a request.

The following parameters can be used to specify information on the requested company. Adding more data points to a request increases the probability of a 200 response. Adding unique parameters like website or profile are more likely to yield a match than a name

Parameter NameDescriptionExample
nameCompany nameGoogle, Inc.
websiteCompany Websitegoogle.com
profileCompany social profile. We currently accept linkedin, facebook, or twitter URLslinkedin.com/company/google

For our Company Enrichment API we require a non-ambiguous match. Because name is not a unique identifier, there are cases where we will return a 404 no match because we are not able to confidently determine one record returned from others with similar names.

Response

When an API request is executed, the queried data points are preprocessed and built into a query, which is then executed against our company dataset. Most profiles and websites map to a unique company. Company names are fuzzy matched based on name appearance relative to different unique company profiles. The company name which appears most frequently in our data is the one who is most likely to be the company returned in a 200 HTTP response code. If we do not find a match we will return a 404 HTTP response code. If we cannot resolve to a unique company based on a name we will also return a 404 response.

Abridged Response Example (full example here):

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

Examples

import requests

url = "https://api.peopledatalabs.com/v5/company/enrich"

querystring = {"website":"google.com"}

headers = {
    'accept': "application/json",
    'content-type': "application/json",
    'x-api-key': "YOUR_API_KEY"
    }

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)
curl -X GET -G \
  'https://api.peopledatalabs.com/v5/company/enrich'\
  -H 'X-Api-Key: xxxx'\
  --data-urlencode 'website=google.com'
import requests

url = "https://api.peopledatalabs.com/v5/company/enrich"

querystring = {
                "website":"google.com",
                "name": "google"
              }

headers = {
    'accept': "application/json",
    'content-type': "application/json",
    'x-api-key': "YOUR_API_KEY"
    }

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)
curl -X GET -G \
  'https://api.peopledatalabs.com/v5/company/enrich'\
  -H 'X-Api-Key: xxxx'\
  --data-urlencode 'name=facebook'\
  --data-urlencode 'website=fb.com'

Full Response

{
  "name": "google",
  "size": "10001+",
  "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_url": "linkedin.com/company/google",
  "linkedin_id": "1441",
  "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",
  "email_domains": [
    "google.com"
  ],
  "ticker": "GOOGL",
  "type": "public",
  "summary": "google is a multinational corporation that specializes in internet-related services and products. the company\u2019s product portfolio includes google search, which provides\u00a0users with access to information online; knowledge graph that allows users to search for things, people, or places as well as builds systems recognizing speech and understanding natural language; google now, which provides information to users when they need it; product listing ads that offer product image, price, and merchant information; \u00a0adwords, an auction-based advertising program; adsense, which enables websites that are part of the google network to deliver ads; google display, a display advertising network; doubleclick ad exchange, a marketplace for the trading display ad space; and youtube that offers video, interactive, and other ad formats.  additionally, the company offers android, an open-source mobile software platform; hardware products, including chromebook, chrome, chromecast, and nexus devices; google+",
  "tags": [
    "media and entertainment",
    "messaging and telecommunications",
    "information technology",
    "video",
    "email",
    "search engine",
    "content and publishing",
    "blogging platforms",
    "advertising",
    "collaboration"
  ],
  "headline": null,
  "alternative_names": [
    "google inc.",
    "google deepmind",
    "google inc",
    "google, inc.",
    "google.com",
    "google fiber",
    "google, inc",
    "google germany gmbh",
    "google india",
    "google ireland"
  ],
  "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"
  ]
}```

 

Updated 24 days ago


Company Enrichment API


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.