AptlyStar

Enrich

B2B data enrichment with Enrich.so

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

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key

Output

ParameterTypeDescription
totalCreditsnumberCurrent credit balance (v3 does not expose a separate lifetime total)
creditsUsednumberAlways 0 — v3's wallet endpoint does not report usage separately from balance
creditsRemainingnumberAvailable credits remaining

enrich_email_to_profile

Retrieve detailed LinkedIn profile information using an email address, including work history, education, and skills.

Input

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
emailstringYesEmail address to look up (e.g., john.doe@company.com). Must be a valid email format.
inRealtimebooleanNoSet to true to retrieve fresh data, bypassing cached information

Output

ParameterTypeDescription
displayNamestringFull display name
firstNamestringFirst name
lastNamestringLast name
headlinestringProfessional headline
occupationstringCurrent company name
summarystringProfile summary
locationstringLocation
countrystringCountry (from profile locale)
linkedInUrlstringLinkedIn profile URL
photoUrlstringProfile photo URL
connectionCountnumberNumber of connections
isConnectionCountObfuscatedbooleanWhether connection count is obfuscated (500+)
positionHistoryarrayWork experience history
↳ titlestringJob title
↳ companystringCompany name
↳ startDatestringStart date
↳ endDatestringEnd date
↳ locationstringLocation
educationarrayEducation history
↳ schoolstringSchool name
↳ degreestringDegree
↳ fieldOfStudystringField of study
↳ startDatestringStart date
↳ endDatestringEnd date
skillsarrayList of skills
localestringProfile locale (e.g., en_US)

enrich_find_email

Find a person's work email address using their full name and company domain.

Input

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
fullNamestringYesPerson'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.
companyDomainstringYesCompany domain (e.g., example.com). Must be a valid domain — a protocol prefix (https://) or trailing path is stripped automatically.

Output

ParameterTypeDescription
emailstringFound email address
firstNamestringFirst name
lastNamestringLast name
domainstringCompany domain
foundbooleanWhether an email was found
acceptAllbooleanWhether the domain accepts all emails (catch-all)

enrich_phone_finder

Find a phone number from a LinkedIn profile URL.

Input

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
linkedinProfilestringYesLinkedIn profile URL (e.g., linkedin.com/in/williamhgates)

Output

ParameterTypeDescription
profileUrlstringLinkedIn profile URL that was looked up
mobileNumberstringFound mobile phone number
foundbooleanWhether a phone number was found
statusstringRequest status

enrich_email_to_phone

Find a phone number associated with an email address.

Input

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
emailstringYesEmail address to look up (e.g., john.doe@example.com). Must be a valid email format.

Output

ParameterTypeDescription
emailstringEmail address looked up
mobileNumberstringFound mobile phone number
foundbooleanWhether a phone number was found
statusstringRequest status

enrich_verify_email

Verify an email address for deliverability, including catch-all detection and provider identification.

Input

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
emailstringYesEmail address to verify (e.g., john.doe@example.com). Must be a valid email format.

Output

ParameterTypeDescription
emailstringEmail address verified
statusstringVerification result
resultstringDeliverability result (e.g., valid, invalid)
confidenceScorenumberApproximate confidence (0–1), derived from Enrich's high/medium/low confidence label
smtpProviderstringEmail service provider (e.g., Google, Microsoft)
mailDisposablebooleanAlways false — v3 no longer reports disposable-email status on this endpoint
mailAcceptAllbooleanWhether the domain is a catch-all domain
freebooleanAlways false — v3 no longer reports free-email-provider status on this endpoint

enrich_ip_to_company

Identify a company from an IP address.

Input

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
ipstringYesIPv4 or IPv6 address to look up (e.g., 86.92.60.221). Must be a valid IP format.

Output

ParameterTypeDescription
namestringOrganization name resolved from the IP
domainstringDomain resolved from the IP
locationjsonGeolocation of the IP
↳ citystringCity
↳ statestringRegion/state
↳ countrystringCountry
↳ timezonestringTimezone

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

ParameterTypeRequiredDescription
apiKeystringYesEnrich API key
companyLinkedinUrlstringYesLinkedIn company URL (e.g., linkedin.com/company/google)
countrystringNoCountry filter (e.g., United States)
jobTitlesjsonNoJob levels to filter by, e.g. ["Senior", "Director"]
pagenumberNoPage number (default: 1). Must be a whole number ≥ 1.
pageSizenumberNoResults per page (default: 10). Must be a whole number between 1 and 100.

Output

ParameterTypeDescription
currentPagenumberCurrent page number
totalPagenumberTotal number of pages
pageSizenumberNumber of results per page
profilesarrayEmployee profiles
↳ profileIdentifierstringLinkedIn profile URL
↳ givenNamestringFirst name
↳ familyNamestringLast name
↳ currentPositionstringCurrent job title
↳ externalProfileUrlstringLinkedIn URL
↳ citystringCity
↳ countrystringCountry
↳ expertSkillsarraySkills

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.

On this page