Enrich.so delivers real-time B2B data enrichment. Its v3 API provides dynamic access to public and structured contact, company, and professional information, enabling teams to build richer profiles, improve lead quality, and drive more effective outreach.
With Enrich.so, you can:
- Enrich contact profiles: Discover key data points for leads and prospects using an email address.
- Find and verify emails: Locate a person's work email from their name and company domain, then verify deliverability.
- Find phone numbers: Look up a phone number from an email address or LinkedIn profile URL.
- Resolve IPs to companies: Identify the organization behind a visitor IP address.
- Find employees at a company: Search for people at a target company by LinkedIn company URL.
The AptlyStar integration with Enrich.so empowers your agents and automations to instantly query and enrich B2B contact data, boosting productivity in workflows like sales prospecting, recruiting, and marketing operations.
Note: This integration mirrors Enrich's current v3 API. Enrich discontinued several operations that previously existed on its v1/v2 API — LinkedIn profile/post/activity search, company lookup/funding/revenue, reverse hash lookup, and logo search are no longer available through Enrich and are not exposed here. Enrich's Lead Finder (people/company search with a paid reveal step for contact info) is a different execution and credit model from the operations below and is not yet wired into this integration pending a product decision.
Usage Instructions
Access real-time B2B contact enrichment with Enrich.so. Enrich profiles from email addresses, find and verify work emails, find phone numbers, resolve IPs to companies, and find employees at a company.
Tools
enrich_check_credits
Check your Enrich API credit balance.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
Output
| Parameter | Type | Description |
|---|---|---|
totalCredits | number | Current credit balance (v3 does not expose a separate lifetime total) |
creditsUsed | number | Always 0 — v3's wallet endpoint does not report usage separately from balance |
creditsRemaining | number | Available credits remaining |
enrich_email_to_profile
Retrieve detailed LinkedIn profile information using an email address, including work history, education, and skills.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
email | string | Yes | Email address to look up (e.g., john.doe@company.com). Must be a valid email format. |
inRealtime | boolean | No | Set to true to retrieve fresh data, bypassing cached information |
Output
| Parameter | Type | Description |
|---|---|---|
displayName | string | Full display name |
firstName | string | First name |
lastName | string | Last name |
headline | string | Professional headline |
occupation | string | Current company name |
summary | string | Profile summary |
location | string | Location |
country | string | Country (from profile locale) |
linkedInUrl | string | LinkedIn profile URL |
photoUrl | string | Profile photo URL |
connectionCount | number | Number of connections |
isConnectionCountObfuscated | boolean | Whether connection count is obfuscated (500+) |
positionHistory | array | Work experience history |
↳ title | string | Job title |
↳ company | string | Company name |
↳ startDate | string | Start date |
↳ endDate | string | End date |
↳ location | string | Location |
education | array | Education history |
↳ school | string | School name |
↳ degree | string | Degree |
↳ fieldOfStudy | string | Field of study |
↳ startDate | string | Start date |
↳ endDate | string | End date |
skills | array | List of skills |
locale | string | Profile locale (e.g., en_US) |
enrich_find_email
Find a person's work email address using their full name and company domain.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
fullName | string | Yes | Person's full name — must include both first and last name (e.g., "John Doe"), per Enrich v3's schema. A first-name-only value is rejected before any request is sent. |
companyDomain | string | Yes | Company domain (e.g., example.com). Must be a valid domain — a protocol prefix (https://) or trailing path is stripped automatically. |
Output
| Parameter | Type | Description |
|---|---|---|
email | string | Found email address |
firstName | string | First name |
lastName | string | Last name |
domain | string | Company domain |
found | boolean | Whether an email was found |
acceptAll | boolean | Whether the domain accepts all emails (catch-all) |
enrich_phone_finder
Find a phone number from a LinkedIn profile URL.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
linkedinProfile | string | Yes | LinkedIn profile URL (e.g., linkedin.com/in/williamhgates) |
Output
| Parameter | Type | Description |
|---|---|---|
profileUrl | string | LinkedIn profile URL that was looked up |
mobileNumber | string | Found mobile phone number |
found | boolean | Whether a phone number was found |
status | string | Request status |
enrich_email_to_phone
Find a phone number associated with an email address.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
email | string | Yes | Email address to look up (e.g., john.doe@example.com). Must be a valid email format. |
Output
| Parameter | Type | Description |
|---|---|---|
email | string | Email address looked up |
mobileNumber | string | Found mobile phone number |
found | boolean | Whether a phone number was found |
status | string | Request status |
enrich_verify_email
Verify an email address for deliverability, including catch-all detection and provider identification.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
email | string | Yes | Email address to verify (e.g., john.doe@example.com). Must be a valid email format. |
Output
| Parameter | Type | Description |
|---|---|---|
email | string | Email address verified |
status | string | Verification result |
result | string | Deliverability result (e.g., valid, invalid) |
confidenceScore | number | Approximate confidence (0–1), derived from Enrich's high/medium/low confidence label |
smtpProvider | string | Email service provider (e.g., Google, Microsoft) |
mailDisposable | boolean | Always false — v3 no longer reports disposable-email status on this endpoint |
mailAcceptAll | boolean | Whether the domain is a catch-all domain |
free | boolean | Always false — v3 no longer reports free-email-provider status on this endpoint |
enrich_ip_to_company
Identify a company from an IP address.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
ip | string | Yes | IPv4 or IPv6 address to look up (e.g., 86.92.60.221). Must be a valid IP format. |
Output
| Parameter | Type | Description |
|---|---|---|
name | string | Organization name resolved from the IP |
domain | string | Domain resolved from the IP |
location | json | Geolocation of the IP |
↳ city | string | City |
↳ state | string | Region/state |
↳ country | string | Country |
↳ timezone | string | Timezone |
Other output fields (legalName, sector, industry, phone, employees, revenue, linkedInUrl, twitterUrl, facebookUrl, domainAliases) are always null/empty — Enrich v3's IP-to-company endpoint returns organization + geolocation/ISP data only, not full firmographics.
enrich_search_company_employees
Find employees at a company by its LinkedIn company URL.
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
apiKey | string | Yes | Enrich API key |
companyLinkedinUrl | string | Yes | LinkedIn company URL (e.g., linkedin.com/company/google) |
country | string | No | Country filter (e.g., United States) |
jobTitles | json | No | Job levels to filter by, e.g. ["Senior", "Director"] |
page | number | No | Page number (default: 1). Must be a whole number ≥ 1. |
pageSize | number | No | Results per page (default: 10). Must be a whole number between 1 and 100. |
Output
| Parameter | Type | Description |
|---|---|---|
currentPage | number | Current page number |
totalPage | number | Total number of pages |
pageSize | number | Number of results per page |
profiles | array | Employee profiles |
↳ profileIdentifier | string | LinkedIn profile URL |
↳ givenName | string | First name |
↳ familyName | string | Last name |
↳ currentPosition | string | Current job title |
↳ externalProfileUrl | string | LinkedIn URL |
↳ city | string | City |
↳ country | string | Country |
↳ expertSkills | array | Skills |
Input Validation
Every operation above validates its required inputs locally before any request is sent to Enrich — invalid input never reaches the Enrich API. On invalid input you'll see a clear message (e.g., "Please enter the person's full name, including first and last name.", "Please enter a valid email address.", "Please enter a valid IP address.") instead of a raw API error.
Removed Operations
The following operations existed against Enrich's older v1/v2 API and have been removed because Enrich's current v3 API no longer supports them: email_to_person_lite, disposable_email_check, email_to_ip, company_lookup, company_funding, company_revenue, search_company, search_similar_companies, search_jobs, search_posts, get_post_details, search_post_reactions (and by-URL variant), search_post_comments (and by-URL variant), search_people_activities, search_company_activities, reverse_hash_lookup, search_logo, linkedin_profile, linkedin_to_work_email, linkedin_to_personal_email, search_people, sales_pointer_people.
If Enrich ships v3 equivalents for these in the future, or a product decision approves adopting Enrich's Lead Finder + Reveal flow for people/company search, they can be re-added — see docs.enrich.so for Enrich's current API reference before reintroducing any of them.