How the Company API Works

What the Company API returns, how credits are charged, and how to configure data freshness.

The Company API gives you a fast, structured way to pull up-to-date information about companies you already know — leads, customers, or competitors. You fetch company details using a LinkedIn URL or domain, rather than searching manually.

What it returns

A standard call may return:

Company name, description, and industry
Website, size, and founding year
Social links (Twitter, LinkedIn, Crunchbase)
Optional enrichments: funding_data, exit_data, acquisitions, and more

You can exclude fields you don't need to reduce credit usage.

Available endpoints

The Company API includes multiple endpoints for different types of company data. For the full list, see the Company API documentation.

How it works

Send a request with either a LinkedIn company URL or a company domain:

https://linkedin.com/company/enrichlayer
enrichlayer.com

The API returns a JSON response with available data. LinkedIn URLs generally produce higher accuracy than domain-only lookups.

Credit usage

A basic Company Profile request costs 1 credit. Usage increases if you:

Enable use_cache=if-recent for data freshness (+1 credit when fresh data is fetched)
Include optional fields:

{
  "funding_data": "include",
  "exit_data": "include",
  "acquisitions": "include"
}

json

To minimize credits, exclude extra fields and leave data freshness off unless you need the latest updates.

Data freshness

Every response includes a last_updated timestamp:

{
  "meta": {
    "last_updated": "2023-10-26T11:34:30Z",
    "thin_profile": false
  }
}

json

When you use use_cache=if-recent, data less than 29 days old is returned from cache — older data triggers a fresh fetch.

Freshness strategy by use case:

Use case	Setting	Cost
Active leads	`use_cache=if-recent`	+1 credit when refreshed
Bulk enrichment	`use_cache=if-present` (default)	Most cost-effective
Critical decisions	`live_fetch=force`	+9 credits

You can set your default use_cache behavior in your dashboard to avoid specifying it in every request.

Privacy-restricted profiles

When thin_profile is true, privacy settings limit data access. You'll receive cached data but cannot refresh it. You won't be charged for failed refresh attempts.

When to use the Company API

Enriching company records in your CRM
Validating domains or LinkedIn URLs on a lead list
Displaying business info in your app or dashboard
Collecting company metadata for analytics or targeting