Send your first Company Enrichment API request

Look Up a Company Profile Using the Company Enrichment API

Next, let’s look at some records in the Company Dataset.

Just as you used the Person Enrichment API to retrieve the profile of a specific person, you can use the Company Enrichment API to retrieve the profile of a specific company. Let’s retrieve the record for People Data Labs using our LinkedIn profile: linkedin.com/company/peopledatalabs/

Sending your first request

Copy the following URL and paste it into a new tab in your browser.

❗️

Before pasting the URL

  • Replace XXXX after api_key with your API key
  • This will consume 1 API credit of your free 100 monthly credits for the Company Enrichment API. To read more about credits, check out this Help Center article
https://api.peopledatalabs.com/v5/company/enrich?api_key=XXXX&pretty=True&profile=linkedin.com/company/peopledatalabs

The result should look something like this:

📘

Pro tip

If you want a better way to work with the result in a browser, consider downloading a JSON Formatting extension

As with records in our Person Dataset, company profiles in our Company Dataset are stored as JSON objects, and they contain information for the fields in our Company Schema.

Try Looking Up Another Company Profile

Next, try looking up another company profile. This time, find your favorite company on LinkedIn. For example, Google. Go to the company’s profile page and copy the URL.

As you should now be trying to get a feel for the type of data available within in the PDL datasets, try a few different LinkedIn URLs. Here are some examples:

  • https://www.linkedin.com/company/google/
  • https://www.linkedin.com/company/amazon/
  • https://www.linkedin.com/company/apple/

Once you have chosen a LinkedIn URL, run the following command:

❗️

Before pasting the URL

  • Replace XXXX after api_key with your API key
  • Replace YYYY after profile with the desired LinkedIn URL
  • This will consume 1 API credit of your free 100 monthly credits for the Company Enrichment API. To read more about credits, check out this Help Center article
https://api.peopledatalabs.com/v5/company/enrich?api_key=XXXX&pretty=True&profile=YYYY

In the response, you should see either:

  • The full PDL company profile associated with the LinkedIn URL that you submitted.
  • An error indicating that no matching record could be found, in which case you can try one of the example LinkedIn URLs listed above.

We encourage you to look up a number of company profiles to get a sense of the type of coverage and information that our datasets offer.


What’s Next