API Documentation

Enrichment

Email Finder

Find a verified work email using name, domain, or LinkedIn URL. Tries multiple providers automatically.

POST

/api/v1/email_finder

5 credits per call

Parameters

Field	Type	Required	Description
`first_name`	string	No	First name (required if no linkedin_url)
`last_name`	string	No	Last name (required if no linkedin_url)
`domain`	string	No	Company domain (required if no linkedin_url)
`linkedin_url`	string	No	LinkedIn profile URL (alternative to name + domain)
`company`	string	No	Company name (optional, improves accuracy)

Response fields

Field	Type	Description
`email`	string	Found work email address
`confidence`	string	Confidence level: high, medium, or low
`provider`	string	Which provider returned this result (internal, not exposed by name)

Code

curl -X POST https://api.richapi.ai/api/v1/email_finder \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "acme.com",
  "last_name": "Doe",
  "first_name": "John"
}'

Try it

Profile Enrichment

Get LinkedIn profile data including name, headline, location, experience, education and more.

POST

/api/v1/enrich_profile

1 credit per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	LinkedIn profile URL
`useCache`	boolean	No	Return cached result if available (default true)

Response fields

Field	Type	Description
`firstname`	string	First name
`lastname`	string	Last name
`headline`	string	LinkedIn headline
`location`	string	Location text
`summary`	string	About / summary section
`profilePicture`	string	Profile picture URL
`linkedinUrl`	string	Canonical LinkedIn URL
`currentCompany`	string	Current employer name
`currentTitle`	string	Current job title
`experience`	array	Work experience entries (company, title, dates)
`education`	array	Education entries (school, degree, dates)
`skills`	array	Listed skills
`languages`	array	Languages spoken
`certifications`	array	Certifications
`connectionCount`	integer	Number of connections
`followerCount`	integer	Number of followers

Code

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

Try it

Company Enrichment

Get company data from LinkedIn including size, industry, specialties and employee insights.

POST

/api/v1/enrich_company

1 credit per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	LinkedIn company page URL
`useCache`	boolean	No	Return cached result if available (default true)

Response fields

Field	Type	Description
`name`	string	Company name
`description`	string	Company description
`website`	string	Company website URL
`industry`	string	Industry category
`companySize`	string	Employee count range (e.g. '1001-5000')
`headquarters`	string	HQ location
`founded`	integer	Year founded
`specialties`	array	Listed specialties
`followerCount`	integer	LinkedIn follower count
`linkedinUrl`	string	Canonical LinkedIn URL
`logo`	string	Logo image URL

Code

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"
}'

Try it

Company Enricher

Enrich a company record with size, industry, funding, tech stack and more via multi-provider waterfall.

POST

/api/v1/company_enricher

2 credits per call

Parameters

Field	Type	Required	Description
`domain`	string	No	Company domain (preferred)
`name`	string	No	Company name (alternative to domain)
`linkedin_url`	string	No	LinkedIn company page URL (alternative)

Response fields

Field	Type	Description
`name`	string	Company name
`domain`	string	Primary domain
`industry`	string	Industry category
`employeeCount`	integer	Approximate employee count
`revenue`	string	Estimated annual revenue range
`founded`	integer	Year founded
`headquarters`	string	HQ location
`linkedinUrl`	string	LinkedIn company page URL
`twitterHandle`	string	Twitter / X handle
`techStack`	array	Detected technologies
`funding`	object	Funding info (totalRaised, lastRound, investors)

Code

curl -X POST https://api.richapi.ai/api/v1/company_enricher \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "domain": "microsoft.com"
}'

Try it

Find Personal Email

Finds a person's personal email addresses using their LinkedIn profile URL.

POST

/api/v1/find_personal_email

5 credits per call

Parameters

Field	Type	Required	Description
`linkedin_url`	string	Yes	LinkedIn profile URL of the person

Response fields

Field	Type	Description
`first_personal_email`	string	Found personal email address
`message`	string	Status message

Code

curl -X POST https://api.richapi.ai/api/v1/find_personal_email \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "linkedin_url": "https://www.linkedin.com/in/johndoe"
}'

Try it

Phone Finder

Find a mobile phone number using a LinkedIn URL or name and company. Tries multiple providers automatically.

POST

/api/v1/phone_finder

25 credits per call

Parameters

Field	Type	Required	Description
`linkedin_url`	string	No	LinkedIn profile URL (preferred)
`first_name`	string	No	First name (required if no linkedin_url)
`last_name`	string	No	Last name (required if no linkedin_url)
`domain`	string	No	Company domain (required if no linkedin_url)

Response fields

Field	Type	Description
`phone`	string	Found mobile phone number (E.164 format when available)
`status`	string	Verification status (verified, unverified)

Code

curl -X POST https://api.richapi.ai/api/v1/phone_finder \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "linkedin_url": "https://www.linkedin.com/in/satyanadella"
}'

Try it

Bulk Profile Enrichment

Fetch up to 50 LinkedIn profiles in a single call using entity URNs.

POST

/api/v1/enrich_profiles_bulk

Parameters

Field	Type	Required	Description
`urns`	array	Yes	List of LinkedIn entity URNs (max 50)

Response fields

Field	Type	Description
`[]`	array	Array of profile objects — same fields as enrich_profile per item

Code

curl -X POST https://api.richapi.ai/api/v1/enrich_profiles_bulk \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urns": [
    "ACoAAAGhXV8B9jFBu7w3NLhsepBqpzJ1FdGgkuA"
  ]
}'

Try it

Bulk Company Enrichment

Fetch up to 50 LinkedIn company profiles in a single call using company IDs.

POST

/api/v1/enrich_companies_bulk

Parameters

Field	Type	Required	Description
`urns`	array	Yes	List of numeric LinkedIn company IDs (max 50)

Response fields

Field	Type	Description
`[]`	array	Array of company objects — same fields as enrich_company per item

Code

curl -X POST https://api.richapi.ai/api/v1/enrich_companies_bulk \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "urns": [
    "1586",
    "1587"
  ]
}'

Try it

Find LinkedIn URL by Email

Finds a LinkedIn profile URL using an email address.

POST

/api/v1/find_linkedin_url_by_email

4 credits per call

Parameters

Field	Type	Required	Description
`email`	string	Yes	Email address of the person

Response fields

Field	Type	Description
`data.LinkedIn Profile URL`	string	LinkedIn profile URL
`status`	string	Status of the request

Code

curl -X POST https://api.richapi.ai/api/v1/find_linkedin_url_by_email \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "john.doe@acme.com"
}'

Try it

Find LinkedIn URL by Name

Finds a LinkedIn profile URL using full name and company name.

POST

/api/v1/find_linkedin_url_by_name

4 credits per call

Parameters

Field	Type	Required	Description
`full_name`	string	Yes	Full name of the person (e.g. Satya Nadella)
`company_name`	string	Yes	Company name (e.g. Microsoft)

Response fields

Field	Type	Description
`data.LinkedIn Profile URL`	string	LinkedIn profile URL
`status`	string	Status of the request

Code

curl -X POST https://api.richapi.ai/api/v1/find_linkedin_url_by_name \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "full_name": "Satya Nadella",
  "company_name": "Microsoft"
}'

Try it

LinkedIn Job Details

Get full LinkedIn job details including description, workplace type, and employment type.

POST

/api/v1/linkedin_job_detail

1 credit per call

Parameters

Field	Type	Required	Description
`job_id`	string	No	ID of the LinkedIn job
`url`	string	No	URL of the LinkedIn job (alternative to job_id)

Response fields

Field	Type	Description
`element.id`	string	Job ID
`element.title`	string	Job title
`element.companyName`	string	Company name
`element.descriptionText`	string	Full job description
`element.employmentType`	string	Employment type (e.g. Full-time)
`element.workplaceType`	string	Workplace type (e.g. Remote)

Code

curl -X POST https://api.richapi.ai/api/v1/linkedin_job_detail \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "job_id": "123456789"
}'

Try it

Find Website by Company Name

Finds a company website URL using its name.

POST

/api/v1/find_website_by_company_name

1 credit per call

Parameters

Field	Type	Required	Description
`company_name`	string	Yes	Name of the company

Response fields

Field	Type	Description
`data.Website`	string	Official company website URL
`status`	string	Status of the request

Code

curl -X POST https://api.richapi.ai/api/v1/find_website_by_company_name \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company_name": "Acme Corp"
}'

Try it