POST /enrich_company • Credits: 1 credit per call

Company Enrichment returns firmographic data for one LinkedIn company page. Send a POST request with the LinkedIn company URL. The response holds the company name, website, industry, company size, headquarters, specialties, description, logo, year of foundation and follower count. Each call costs 1 credit.

What does Company Enrichment do?

Sales teams and marketers hold lists of LinkedIn company pages without firmographic data. Company Enrichment closes that gap. The endpoint reads the public LinkedIn company page for the URL that you send. It returns the company profile as structured JSON in one synchronous response. The data source is LinkedIn. One call covers one company.

Which endpoint does Company Enrichment use?

Method: POST
URL: https://api.richapi.ai/api/v1/enrich_company
Authentication: x-api-key header
Response: synchronous JSON
Credits: 1 credit per call

How to send a Company Enrichment request

Copy your API key from the RichAPI dashboard.
Open the LinkedIn company page in a browser.
Copy the company URL from the address bar.
Set the url parameter to that LinkedIn company URL.
Send a POST request to https://api.richapi.ai/api/v1/enrich_company.
Send the API key in the x-api-key header.
Read the company fields from the response.

CAUTION: Each Company Enrichment call costs 1 credit. To enrich many companies in one request, send Bulk Company Enrichment API instead.

cURL

curl -X POST https://api.richapi.ai/api/v1/enrich_company   
  -H "x-api-key: YOUR_API_KEY"   
  -H "Content-Type: application/json"   
  -d '{
    "url": "https://www.linkedin.com/company/microsoft"
  }'

Python

import requests

response = requests.post(
    "https://api.richapi.ai/api/v1/enrich_company",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"url": "https://www.linkedin.com/company/microsoft"},
    timeout=60,
)
response.raise_for_status()
print(response.json())

Node.js

const response = await fetch("https://api.richapi.ai/api/v1/enrich_company", {
  method: "POST",
  headers: {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.linkedin.com/company/microsoft",
  }),
});

const data = await response.json();
console.log(data);

What parameters does Company Enrichment accept?

Parameter	Type	Required	Default	Description
`url`	string	Yes	`""`	The LinkedIn company URL, for example `https://www.linkedin.com/company/microsoft`.

Why does Company Enrichment reject the useCache parameter?

url is the only body field that Company Enrichment accepts. RichAPI validates the request body against the field list of the endpoint. Any other key makes the API return 400 with the message Unknown input field(s).

CAUTION: Do not send useCache in the request body. The API returns 400 Unknown input field(s): useCache and charges no credit.

Some older RichAPI reference material lists useCache as a parameter. If you send useCache in your request body, the call fails with 400.

Body key	Accepted from a customer	Result
`url`	Yes	The API enriches the LinkedIn company page.
`useCache`	No	The API returns `400 Unknown input field(s): useCache`.
Any other key	No	The API returns `400 Unknown input field(s)` with the key name.

Company data can be up to 24 hours old. The caller cannot turn the cache off.

Which company identifier gives the most reliable match?

The LinkedIn company URL is the only company identifier that Company Enrichment accepts. It gives the most reliable match, because the URL names one exact LinkedIn company page. A company name matches more than one page, so RichAPI does not accept a name on this endpoint.

Identifier that you hold	What to do
LinkedIn company URL	Send it as the `url` parameter.
Company name only	Send Find Website by Company Name API first, then find the LinkedIn company URL.
Many LinkedIn company URLs	Send Bulk Company Enrichment API.

What does Company Enrichment return?

Company Enrichment returns one flat JSON object with 11 fields. The following example shows the response for https://www.linkedin.com/company/microsoft. The values are illustrative, and the live values come from the LinkedIn company page.

{
  "logo": "https://media.licdn.com/dms/image/company-logo/microsoft_200_200.png",
  "name": "Microsoft",
  "founded": 1975,
  "website": "https://www.microsoft.com",
  "industry": "Software Development",
  "companySize": "10,001+ employees",
  "description": "Every company has a mission. What is ours? To empower every person and every organization on the planet to achieve more.",
  "linkedinUrl": "https://www.linkedin.com/company/microsoft",
  "specialties": [
    "Business Software",
    "Developer Tools",
    "Cloud Computing",
    "Artificial Intelligence"
  ],
  "headquarters": "Redmond, Washington, United States",
  "followerCount": 22500000
}

What does each Company Enrichment response field mean?

Field	Type	Description
`logo`	string	The URL of the company logo image.
`name`	string	The company name as shown on LinkedIn.
`founded`	integer	The year that the company started.
`website`	string	The company website URL.
`industry`	string	The LinkedIn industry classification of the company.
`companySize`	string	The headcount band of the company, as shown on LinkedIn.
`description`	string	The company description from the LinkedIn About section.
`linkedinUrl`	string	The LinkedIn company page URL.
`specialties`	array	The specialties that the company lists on LinkedIn.
`headquarters`	string	The headquarters location of the company.
`followerCount`	integer	The number of LinkedIn followers of the company page.

How much does Company Enrichment cost?

Company Enrichment costs 1 credit per call. One credit costs $0.02 on the 1,000 and 5,000 credit packs. Larger packs cost less per credit. 500 calls cost 500 credits, and 500 credits cost $10.00.

Calls	Credits	Cost
1	1	$0.02
100	100	$2.00
500	500	$10.00
1,000	1,000	$20.00
10,000	10,000	$200.00

RichAPI charges a credit only for a successful call. A failed call costs no credit.

What errors does Company Enrichment return?

An error response holds an error field with a text message.

Status	Meaning	What to do
`400`	The request body failed validation.	Correct the parameter that the message names.
`401`	The API key is missing, wrong or revoked.	Send a valid key in the `x-api-key` header.
`402`	`Insufficient credits`: the organization has too few credits for this call. Or `Monthly spend limit reached`: the team hit its monthly spend limit.	Buy credits in the RichAPI dashboard, or ask the organization owner to raise the spend limit, then send the request again.
`403`	`Endpoint not available on your plan`: this API key has no access to this endpoint.	Call `GET /api/v1/my-endpoints` to list the endpoints this key can use. Contact support for access.
`404`	The endpoint name is wrong.	Send the request to `/enrich_company`.
`429`	Rate limit exceeded (too many requests per second).	Wait for the `Retry-After` seconds, then retry the request.
`500`	The API failed.	Send the request again. If the failure repeats, contact support.
`502`	The upstream data provider failed.	Send the request again after a short wait.
`504`	The upstream data provider timed out.	Send the request again after a short wait.

For a retry loop, wait 1 second, then 2 seconds, then 4 seconds between attempts.

Frequently asked questions

What input does the Company Enrichment API need?

The Company Enrichment API needs one LinkedIn company URL in the url parameter. An example URL is https://www.linkedin.com/company/microsoft.

How much does the Company Enrichment API cost per company?

The Company Enrichment API costs 1 credit per call, and one call covers one company. One credit costs $0.02 on the 1,000 and 5,000 credit packs, so 1,000 companies cost $20.00 there.

Can I turn off the cache on the Company Enrichment API?

No. The Company Enrichment API accepts only the url body field, and it returns 400 Unknown input field(s): useCache for a useCache key. Company data can be up to 24 hours old.

Can the Company Enrichment API enrich a company from a company name?

No. The Company Enrichment API accepts only a LinkedIn company URL. If you hold a company name alone, send Find Website by Company Name API first.

How do I enrich many companies at once?

Send Bulk Company Enrichment API for many companies in one request. Company Enrichment covers one company per call.

Is the Company Enrichment API synchronous?

Yes. The Company Enrichment API returns the company data in the same response. The endpoint needs no second call and no webhook.