The Company Enrichment API provides a one-to-one company match. The company data provided by this endpoint includes all the fields in our Company Schema.
The endpoint for the Company Enrichment API is
When the API finds a matching company, it returns this company along with an HTTP response code of
200. When it doesn't find a matching company, it returns an HTTP response code of
404. We charge per match.
The standard rate limit is 10 per minute for free customers and 1,000 per minute for paying customers.
When querying the API in URL, you can add data points to a queried company as key/value pairs at the end of a
v5 request string.
You can use the following parameters to specify information about the requested company. Adding more data points to a request increases the probability of a
200 response and increases the likelihood score. Adding unique parameters such as
profile are more likely to yield a match than a
For More Details, See Input Parameters - Company Enrichment API
You can also click on the individual parameter names in the table below to view more information on them.
|The PDL ID for a record in our Company Dataset.
Note: If you enrich on ID and anything else, only ID is used and the other inputs for matching are ignored.
|The company's name.
|The company's social profile.
|The company's stock ticker, if publicly traded.
|The company's website.
|The complete or partial company location. You can input multiple location values.
1600 Amphitheatre Pkwy, Mountain View, CA 94043
|The company's locality. You can only input one locality.
|The company's region. You can only input one region.
|The company's country. You can only input one country.
|The company's street address. You can only input one street address.
1600 Amphitheatre Pkwy
|The company's postal code. You can only input one postal code.
|Your secret API key. Note: You can also provide this in the request header instead, as shown on the Authentication page.
For our Company Enrichment API, we require a non-ambiguous match. This means that you must input a
You are not required to use the following additional input parameters. They generally transform or control various aspects of the enrichment process (returning matches or formatting results.)
|All text in API responses returns as lowercase by default. Setting titlecase to
true will titlecase the person data in
|Whether the output should have human-readable indentation.
true, the response includes the top-level field
matched (along with
status and so forth), which includes a value for each queried field parameter that was matched during our internal query.
likelihood score that a response must have to return a
|The fields a response must have to return a
|A comma-separated string of fields that you want the response to include.
Begin the string with a
- if you want to exclude the specified fields. If you want to exclude all data from being returned, use
When you execute an API request, we preprocess the queried data points and build them into a query, which we then execute against our Company Dataset. Most profiles and websites map to a unique company. We fuzzy-match company names based on name appearance relative to different unique company profiles. The company name that appears most frequently in our data is the one that is most likely to be the company returned in a
200 HTTP response code. If we do not find a match or cannot resolve the query to a unique company based on a
name, we will return a
404 HTTP response code.
For More Details, See Output Response - Company Enrichment API
You can also click the field names in the table below to view more information on them.
|The response code (see a description of our error codes).
|The degree of confidence. The field is an integer between
10 that represents how confident we are that the company that we returned is the same as the company that you requested. You can control the minimum likelihood score a response must have in order to return a
200 by using the
min_likelihood parameter in the API request.
|The matched profile record containing fields from our Company Schema. Any fields in the profile record that do not contain any data will have a
Here is an example response from the Company Enrichment API:
"name": "people data labs",
See Example Company Record for a full example of the fields included in the response object.
If the request encounters an error, it will instead return an Error Response in the format described in Errors.
Updated 2 months ago