Data catalog / enrichment
Enrichment data
Turn what you have about a person or a company (a LinkedIn URL, a name, an email, a domain) into a full record, an email address or a phone number. This page maps each starting point to the endpoint that takes it, with the credit rate for each.
In short: RichAPI's enrichment endpoints: POST /enrich_profile (LinkedIn profile URL to person record, 1 credit, 2 with include_social_metrics), POST /enrich_company (LinkedIn company URL to company record, 1 credit), POST /enrich_profiles_bulk and /enrich_companies_bulk (up to 50 URNs or numeric company IDs, 1 credit per result), POST /find_linkedin_url_by_email and /find_linkedin_url_by_name (4 credits), POST /find_website_by_company_name (1 credit), POST /email_finder (5 credits), POST /find_personal_email (5 credits), POST /phone_finder (25 credits). email_finder and phone_finder are waterfall endpoints: a call where no source returns data bills zero. Other endpoints bill on any 2xx response.
Last updated November 4, 2026
Start from what you have
Enrichment endpoints each take one kind of input. Find the row that matches what you already hold:
| You have | Call | You get |
|---|---|---|
| A LinkedIn profile URL | enrich_profile |
The person: headline, current role, experience, education |
| A LinkedIn company URL | enrich_company |
The company: industry, size, headquarters, website |
| Up to 50 profile URNs or company IDs | enrich_profiles_bulk, enrich_companies_bulk |
The same records, 50 per call |
| An email address | find_linkedin_url_by_email |
The LinkedIn profile URL behind it |
| A full name and a company name | find_linkedin_url_by_name |
A LinkedIn profile URL |
| A company name | find_website_by_company_name |
The company website |
| A name and a company domain, or a LinkedIn URL | email_finder |
A work email |
| A LinkedIn URL | find_personal_email, phone_finder |
A personal email, a mobile number |
Most jobs chain two of these. An email list becomes LinkedIn URLs, then person records. A name and a company become a LinkedIn URL, then a work email.
Two billing rules
email_finder and phone_finder are waterfall endpoints. They ask several sources in turn and stop at the first that has an answer. When none has one, the call returns billed: false and costs nothing. These are the expensive lookups, 5 credits for an email and 25 for a phone number, so not paying for misses changes what a list costs.
Every other endpoint here bills on any 2xx response, including one that comes back empty. enrich_profile costs 1 credit, or 2 with include_social_metrics, and the extra credit is not charged when the metrics are unavailable. find_linkedin_url_by_email costs 4 credits on any 2xx response, including one with no profile in it.
Endpoints and rates
| Endpoint | What it does | Credits | Billed |
|---|---|---|---|
/enrich_profile |
Get LinkedIn profile data including name, headline, location, experience, education and more. | 1, or 2 with social metrics | per call |
/enrich_company |
Get company data from LinkedIn including size, industry, specialties and employee insights. | 1 | per call |
/enrich_profiles_bulk |
Fetch up to 50 LinkedIn profiles in a single call using entity URNs. | 1 | per result |
/enrich_companies_bulk |
Fetch up to 50 LinkedIn company profiles in a single call using company IDs. | 1 | per result |
/profile_social_metrics |
Get LinkedIn profile verification status, follower count, and connection count. | 1 | per call |
/find_linkedin_url_by_email |
Finds a LinkedIn profile URL using an email address. | 4 | per call |
/find_linkedin_url_by_name |
Finds a LinkedIn profile URL using full name and company name. | 4 | per call |
/find_website_by_company_name |
Finds a company website URL using its name. | 1 | per call |
/email_finder |
Find a verified work email using name, domain, or LinkedIn URL. | 5 | per call |
/find_personal_email |
Finds a person's personal email addresses using their LinkedIn profile URL. | 5 | per call |
/phone_finder |
Find a mobile phone number using a LinkedIn URL or name and company. | 25 | per call |
/linkedin_job_detail |
Get full LinkedIn job details including description, workplace type, and employment type. | 1 | per call |
Rates are read from the live OpenAPI spec. Credits are prepaid and never expire, and the price of a credit depends on your package: see pricing.
Single lookups or bulk
The bulk endpoints take up to 50 identifiers per call and bill 1 credit per record returned. They take entity URNs for people and numeric LinkedIn IDs for companies, not URLs. Use them when you already hold those IDs, for example from a search that returned them. When all you have is URLs, call the single endpoints. Enrich in bulk without buying seats covers running this as a scheduled job.
Pages for each endpoint
Each common lookup has its own page with the request, the response and the gotchas:
- Person enrichment and company enrichment
- Email finder, email verifier and phone finder
- Email to LinkedIn profile
For what enrichment means in general, and how a waterfall works, see the glossary entries on data enrichment and waterfall enrichment.
Reference
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | LinkedIn profile URL |
include_social_metrics | boolean | No | Include optional social metrics when available. |
urlstring · Required- LinkedIn profile URL
include_social_metricsboolean · Optional- Include optional social metrics when available.
Request
Minimum required parameters for a enrichment data call.
{
"url": "https://www.linkedin.com/in/satyanadella",
"include_social_metrics": true
}See it in a workflow
Playbooks
Real patterns, recipes, and prompts other builders run on RichAPI
Developer Docs
Auth, request shape, and error handling
FAQ
