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:

For what enrichment means in general, and how a waterfall works, see the glossary entries on data enrichment and waterfall enrichment.

Reference

urlstring · Required
LinkedIn profile URL
include_social_metricsboolean · Optional
Include optional social metrics when available.

Request

Minimum required parameters for a enrichment data call.

Request
{
  "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

Start free with 100 credits

Developer Docs

Auth, request shape, and error handling

See Documentation

FAQ

Frequently asked questions

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.
Every endpoint is billed from the same credit pool, at the published rate on /pricing — never a separate contract per endpoint.
Yes — the same endpoint is reachable from an MCP client (Claude, ChatGPT, Cursor, Windsurf) using the same key and credit pool. See /mcp.

Related data