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)
`company_domain`	string	No	Company domain (required if no linkedin_url)
`linkedin_url`	string	No	LinkedIn profile URL (alternative to name + domain)
`company_name`	string	No	Company name (optional, improves accuracy)

Example response

json

{
  "confidence": "example",
  "email": "example",
  "provider": "example"
}

Code

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

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

1 credit per record

Parameters

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

Code

curl -X POST https://dev-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

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

Example response

json

{
  "companySize": "example",
  "description": "example",
  "followerCount": 1,
  "founded": 1,
  "headquarters": "example",
  "industry": "example",
  "linkedinUrl": "example",
  "logo": "example",
  "name": "example",
  "specialties": [],
  "website": "example"
}

Code

curl -X POST https://dev-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

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

Example response

json

{
  "certifications": [],
  "connectionCount": 1,
  "currentCompany": "example",
  "currentTitle": "example",
  "education": [],
  "experience": [],
  "firstname": "example",
  "followerCount": 1,
  "headline": "example",
  "languages": [],
  "lastname": "example",
  "linkedinUrl": "example",
  "location": "example",
  "profilePicture": "example",
  "skills": [],
  "summary": "example"
}

Code

curl -X POST https://dev-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

Bulk Profile Enrichment

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

POST

/api/v1/enrich_profiles_bulk

1 credit per record

Parameters

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

Code

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

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

Example response

json

{
  "data": {
    "LinkedIn Profile URL": "example"
  },
  "status": "example"
}

Code

curl -X POST https://dev-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)

Example response

json

{
  "data": {
    "LinkedIn Profile URL": "example"
  },
  "status": "example"
}

Code

curl -X POST https://dev-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

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

Example response

json

{
  "data": {
    "email": "santoshelect13@gmail.com",
    "status": "ok",
    "verifier": "Million Verifier"
  },
  "id": "6a6874c544af2d8d82d07ed3",
  "status": "success"
}

Code

curl -X POST https://dev-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

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

Example response

json

{
  "data": {
    "Website": "example"
  },
  "status": "example"
}

Code

curl -X POST https://dev-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": "amazon"
}'

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)

Example response

json

{
  "element": {
    "companyName": "example",
    "descriptionText": "example",
    "employmentType": "example",
    "id": "example",
    "title": "example",
    "workplaceType": "example"
  }
}

Code

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

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)

Example response

json

{
  "phone": "+14155552671",
  "status": "verified"
}

Code

curl -X POST https://dev-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",
  "first_name": "Satya",
  "last_name": "Nadella",
  "domain": "microsoft.com"
}'

Try it

Profile Social Metrics

Get LinkedIn profile verification status, follower count, and connection count.

POST

/api/v1/profile_social_metrics

1 credit per call

Parameters

Field	Type	Required	Description
`url`	string	Yes	LinkedIn profile URL to retrieve social metrics for.
`useCache`	bool	No	Use the provider's cached profile data when available.

Example response

json

{
  "connectionsCount": 8,
  "followersCount": 39886493,
  "verified": false
}

Code

curl -X POST https://dev-api.richapi.ai/api/v1/profile_social_metrics \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://www.linkedin.com/in/williamhgates",
  "useCache": false
}'

Try it