Enrich
App · 20 actions
Use Enrich.so to validate emails, find work and personal emails, look up the person behind an email, and search, count and reveal B2B leads with Lead Finder.
Actions
| Action | What it does |
|---|---|
| Count leads | Count the Lead Finder leads matching a set of filters, to size a search before running it. |
| Delete saved search | Delete one of your saved Lead Finder searches. |
| Find best-fit people at a company | Rank the people at a company against your ideal customer profile: titles, seniority, departments, skills and place. |
| Find company employees | List people who work at a company, from its LinkedIn page, filtered by place, seniority and department. |
| Find person by email | Look up the professional profile behind an email address: name, headline, company, location, jobs and schools. |
| Find personal email | Find a personal email address from someone's LinkedIn profile. |
| Find work email | Find someone's work email from their name and company domain. |
| Get credit balance | Get your Enrich organization's credit balance. |
| Get email batch results | Get one page of a validation batch's results, optionally waiting for the batch to finish first. |
| Get email batch status | Get a validation batch's status (queued, processing, completed or failed) and progress. |
| Get reveal job | Get a reveal job's status and, once completed, the revealed contacts. |
| List credit transactions | List credits spent, bought, adjusted and refunded, newest first, one page at a time. |
| List saved searches | List your saved Lead Finder searches and their filters. |
| Reveal lead contacts | Reveal work and personal emails for up to 25 leads from 'Search leads', waiting for Enrich to finish. |
| Save search | Save a set of Lead Finder filters under a name. |
| Search leads | Search Enrich's Lead Finder for people by job, company and place. |
| Suggest cities | Find the city names Lead Finder knows that match some text, to use in a search's 'Cities people live in'. |
| Suggest company names | Find the company names Lead Finder knows that match some text, to use in a search's 'Company names'. |
| Validate email | Check whether an email address can receive mail: valid, invalid or risky, with the mail provider and whether the domain accepts every address. |
| Validate emails in bulk | Queue up to 1,000 email addresses for validation. |
Count leads
Count the Lead Finder leads matching a set of filters, to size a search before running it. Free.
Inputs
- Job titles
job_titleslist - Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
- Seniority
job_levelslist - Only people at these levels.One or more of:
C-Team,VP,Director,Manager,Staff,Other. - Department
job_functionslist - Only people in these departments.One or more of:
Advertising & Marketing,Art, Culture and Creative Professionals,Construction,Customer/Client Service,Education,Engineering,Finance & Accounting,General Business & Management,Healthcare & Human Services,Human Resources, and 12 more. - Company names
company_nameslist - Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
- Company name match
company_name_modetext - Match company names exactly, or any name containing them.One of:
exact(Exact name),contains(Name contains). - Company domains
domainslist - Company websites, such as stripe.com. URLs are cleaned up.
- Cities people live in
citieslist - City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
- Countries people live in
countrieslist - Only people in these countries. Up to 20.
- Industries
industrieslist - Only companies in these LinkedIn industries. Up to 20.
- Company headquarters countries
headquarters_countrieslist - Only companies headquartered in these countries. Up to 20.
- Fewest employees
employee_count_minnumber - Only companies with at least this many employees.At least 0.
- Most employees
employee_count_maxnumber - Only companies with at most this many employees.At least 0.
- LinkedIn headline words
person_headlineslist - Words in the person's LinkedIn headline. Up to 10.
- Skills
skillslist - Skills listed on the profile, matched exactly. Up to 25.
- Current job only
current_job_onlytrue/false - Match only the job people hold now, not past ones.
- More filters
more_filtersobject - Any other Lead Finder filters, named as Enrich's docs name them, such as {"revenueBuckets": ["$10M-$50M"]}. The fields before this one win where both are set.
- Leave out job titles
exclude_job_titleslist - Leave out anyone whose job title contains these words. Up to 25.
Outputs
countnumber- How many leads match
isApproximatetrue/false- Whether the count is an estimate
searchTypetext- people, company or unified
searchedTotalResultnumber- Rows searched
Example output
{
"count": 1240,
"isApproximate": false,
"searchType": "people",
"searchedTotalResult": 1240
}Delete saved search
Delete one of your saved Lead Finder searches. Free.
Inputs
- Saved search ID
search_idtextRequired - The id from 'List saved searches' or 'Save search'.
Outputs
deletedtrue/false- Always true
idtext- The deleted search's id
Example output
{
"deleted": true,
"id": "ss_664f2b3c9a1e4d0012abcd01"
}Find best-fit people at a company
Rank the people at a company against your ideal customer profile: titles, seniority, departments, skills and place. Leave those empty to look for CEO and founders, then C-suite, VPs and directors. 1 credit a person returned.
Inputs
- Company LinkedIn page
company_linkedin_urltextRequired - The company's LinkedIn page, such as https://www.linkedin.com/company/stripe, or just its name in that address (stripe).
- Job titles
include_titleslist - Titles to look for, such as Head of Sales.
- Leave out job titles
exclude_titleslist - Titles to leave out, such as Intern.
- Seniority
job_levelslist - Levels such as Owner, Founder, C-Level, Partner, VP, Director, Manager, Senior, Staff, Entry or Intern.
- Departments
job_functionslist - Departments such as Engineering, Marketing or Sales.
- Skills
skillslist - Skills that raise a person's score.
- Locations
locationslist - Two-letter country codes (US, DE), continents (NORTH_AMERICA, EUROPE) or WORLD.
- Match titles in headlines
include_headline_searchtrue/false - Also look for the job titles in LinkedIn headlines.
- Most people
max_resultsnumber - 1 to 100, each costing a credit. Enrich's default is 25.From 1 to 100.
- Lowest score
min_scorenumber - Leave out people scoring under this, 0 to 100.From 0 to 100.
Outputs
cascade_statslist- Candidates at each level
metaobject- The request id, and the credits this call used and has left
resultslist- The people, best first
total_foundnumber- Candidates found
total_returnednumber- People returned
Example output
{
"cascade_stats": [
{
"candidates_found": 12,
"candidates_kept": 1,
"level": 0
}
],
"meta": {
"creditsRemaining": 89,
"creditsUsed": 1,
"processingTimeMs": 840,
"requestId": "req_664f2b3c9a1e4d0012abcdef"
},
"results": [
{
"cascade_level": 0,
"certifications": null,
"current_position": {
"company": "Stripe",
"function": "Engineering",
"is_current": true,
"level": "C-Level",
"start_date": "2020-01-15",
"title": "CTO"
},
"education": "Stanford University",
"person": {
"email_domain": "stripe.com",
"first_name": "Jane",
"last_name": "Doe",
"linkedin_headline": "CTO at Stripe",
"linkedin_url": "https://www.linkedin.com/in/jane-doe",
"location": "San Francisco, California, United States"
},
"ranking": 1,
"ranking_factors": {
"current_job": 10,
"experience": 5,
"job_level": 20,
"location_match": 10,
"priority_bonus": 0,
"profile_completeness": 7,
"skills_overlap": 10,
"title_match": 30
},
"score": 92,
"skills": [
"Python"
],
"what_matched": [
"title: CTO"
]
}
],
"total_found": 12,
"total_returned": 1
}Find company employees
List people who work at a company, from its LinkedIn page, filtered by place, seniority and department. 1 credit a person returned.
Inputs
- Company LinkedIn page
company_linkedin_urltextRequired - The company's LinkedIn page, such as https://www.linkedin.com/company/stripe, or just its name in that address (stripe).
- Countries
countrieslist - Country names, such as United States. Up to 50.
- Continents
continentslist - Continent names, such as Europe.
- Sales regions
sales_regionslist - Sales regions, such as EMEA.
- Seniority
job_levelslist - Seniority levels, such as Director.
- Departments
job_functionslist - Departments, such as Engineering.
- Most people
max_resultsnumber - 1 to 100, each costing a credit. Enrich's default is 10.From 1 to 100.
- Page
pagenumber - Which page to return, from 1.At least 1.
Outputs
company_linkedin_urltext- The company searched
max_resultsnumber- Most people asked for
metaobject- The request id, and the credits this call used and has left
pagenumber- This page
resultslist- The people
results_lengthnumber- People on this page
total_pagesnumber- Pages available
total_resultsnumber- People found in all
Example output
{
"company_linkedin_url": "https://www.linkedin.com/company/stripe/",
"max_results": 10,
"meta": {
"creditsRemaining": 89,
"creditsUsed": 1,
"processingTimeMs": 840,
"requestId": "req_664f2b3c9a1e4d0012abcdef"
},
"page": 1,
"results": [
{
"about_me": null,
"certifications": null,
"education": "Stanford University",
"first_name": "Jane",
"full_name": "Jane Doe",
"headline": "VP of Engineering at Stripe",
"job_function": "Engineering",
"job_is_current": true,
"job_level": "VP",
"job_title": "VP of Engineering",
"last_name": "Doe",
"linkedin_url": "https://www.linkedin.com/in/jane-doe",
"location": {
"city": "San Francisco",
"continent": "North America",
"country": "United States",
"country_code": "US",
"state_code": "CA"
},
"skills": "Python, Distributed Systems"
}
],
"results_length": 1,
"total_pages": 1,
"total_results": 1
}Find person by email
Look up the professional profile behind an email address: name, headline, company, location, jobs and schools. 10 credits, none when nobody is found.
Inputs
- Email address
emailtextRequired - The email address, such as jane@example.com.
Outputs
companyNametext- Current company
connectionCountnumber- LinkedIn connections
creditsConsumednumber- Credits the lookup used
displayNametext- Full name
emailtext- The email looked up
firstNametext- First name
foundtrue/false- Whether a profile was found
headlinetext- LinkedIn headline
idtext- The profile's id
isConnectionCountObfuscatedtrue/false- Whether the count is capped, as 500+
isPublictrue/false- Whether the profile is public
lastNametext- Last name
localeobject- The profile's country and language
locationtext- Where they are
metaobject- The request id, and the credits this call used and has left
photoUrltext- Photo URL
positionsobject- Work history
profileUrltext- LinkedIn profile URL
reportProfileUrltext- Link to report the profile
schoolsobject- Education
skillslist- Skills listed
summarytext- About section
Example output
{
"companyName": "Stripe",
"connectionCount": 500,
"creditsConsumed": 10,
"displayName": "Jane Doe",
"email": "jane@stripe.com",
"firstName": "Jane",
"found": true,
"headline": "VP of Engineering at Stripe",
"id": "ACoAAB1234",
"isConnectionCountObfuscated": true,
"isPublic": true,
"lastName": "Doe",
"locale": {
"country": "US",
"language": "en"
},
"location": "San Francisco, California",
"meta": {
"creditsRemaining": 89,
"creditsUsed": 10,
"processingTimeMs": 840,
"requestId": "req_664f2b3c9a1e4d0012abcdef"
},
"photoUrl": null,
"positions": {
"positionHistory": [
{
"companyLocation": "San Francisco",
"companyLogo": null,
"companyName": "Stripe",
"description": null,
"startEndDate": {
"end": null,
"start": {
"month": 1,
"year": 2020
}
},
"title": "VP of Engineering"
}
],
"positionsCount": 1
},
"profileUrl": "https://www.linkedin.com/in/jane-doe",
"reportProfileUrl": null,
"schools": {
"educationHistory": [
{
"degreeName": "BSc Computer Science",
"schoolLocation": null,
"schoolLogo": null,
"schoolName": "Stanford University",
"startEndDate": {
"end": {
"month": 6,
"year": 2012
},
"start": {
"month": 9,
"year": 2008
}
}
}
],
"educationsCount": 1
},
"skills": [
"Python",
"Distributed Systems"
],
"summary": "Building payments infrastructure."
}Find personal email
Find a personal email address from someone's LinkedIn profile. 10 credits, none when nothing is found.
Inputs
- LinkedIn profile
linkedin_urltextRequired - The person's LinkedIn profile, such as https://www.linkedin.com/in/jane-doe.
Outputs
foundtrue/false- Whether an email was found
linkedinUrltext- The profile looked up
metaobject- The request id, and the credits this call used and has left
personalEmailtext- The personal email, or empty when none
Example output
{
"found": true,
"linkedinUrl": "https://www.linkedin.com/in/jane-doe",
"meta": {
"creditsRemaining": 89,
"creditsUsed": 10,
"processingTimeMs": 840,
"requestId": "req_664f2b3c9a1e4d0012abcdef"
},
"personalEmail": "jane.doe@gmail.com"
}Find work email
Find someone's work email from their name and company domain. 10 credits, none when nothing is found.
Inputs
- First name
first_nametextRequired - The person's first name.
- Last name
last_nametextRequired - The person's last name.
- Company domain
domaintextRequired - The company's website, such as figma.com. A full URL or an email address at the company works too.
Outputs
confidencetext- high, medium or low
domaintext- Domain searched
emailtext- The work email, when found
firstNametext- First name searched
foundtrue/false- Whether an email was found
isCatchAlltrue/false- Whether the domain accepts every address
lastNametext- Last name searched
messagetext- Enrich's explanation
metaobject- The request id, and the credits this call used and has left
providertext- The mail provider
Example output
{
"confidence": "high",
"domain": "figma.com",
"email": "jane.doe@figma.com",
"firstName": "Jane",
"found": true,
"isCatchAll": false,
"lastName": "Doe",
"message": "Email found",
"meta": {
"creditsRemaining": 89,
"creditsUsed": 10,
"processingTimeMs": 840,
"requestId": "req_664f2b3c9a1e4d0012abcdef"
},
"provider": "GOOGLE"
}Get credit balance
Get your Enrich organization's credit balance. Free.
Inputs
None.
Outputs
asOftext- When the balance was read (ISO 8601)
balancenumber- Credits available
currencytext- Always credits
organizationIdtext- The Enrich organization's id
Example output
{
"asOf": "2026-03-02T10:00:00.000Z",
"balance": 100,
"currency": "credits",
"organizationId": "org_664f2b3c9a1e4d0012ab"
}Get email batch results
Get one page of a validation batch's results, optionally waiting for the batch to finish first. Unused reserved credits are refunded once it has.
Inputs
- Batch ID
batch_idtextRequired - The batchId from 'Validate emails in bulk'.
- Wait to finish (seconds)
wait_secondsnumber - Up to 120. If the batch is still running, check every few seconds until it finishes or this time is up.From 0 to 120.
- Page
pagenumber - Which page to return, from 1.At least 1.
- Page size
limitnumber - Results per page, 1 to 1,000. Enrich's default is 100.From 1 to 1000.
Outputs
batchIdtext- The batch's id
metaobject- The request id, the credits settled for the batch, and progress
processedCountnumber- Addresses checked
resultslist- One per address
statustext- The batch's status
totalItemsnumber- Addresses in the batch
Example output
{
"batchId": "batch_664f2b3c9a1e4d0012ab",
"meta": {
"creditsRefunded": 0,
"creditsRemaining": 88,
"creditsUsed": 1,
"processedItems": 1,
"requestId": "req_664f2b3c9a1e4d0012abcdf1",
"totalItems": 1
},
"processedCount": 1,
"results": [
{
"confidence": "high",
"email": "jane@example.com",
"hasSEG": false,
"isCatchAll": false,
"isFederated": false,
"message": "Mailbox exists",
"provider": "GOOGLE",
"result": "valid",
"segProvider": null
}
],
"status": "completed",
"totalItems": 1
}Get email batch status
Get a validation batch's status (queued, processing, completed or failed) and progress. Free.
Inputs
- Batch ID
batch_idtextRequired - The batchId from 'Validate emails in bulk'.
Outputs
batchIdtext- The batch's id
processedItemsnumber- Addresses checked so far
progressnumber- Percent done, 0 to 100
statustext- queued, processing, completed or failed
totalItemsnumber- Addresses in the batch
Example output
{
"batchId": "batch_664f2b3c9a1e4d0012ab",
"processedItems": 2,
"progress": 100,
"status": "completed",
"totalItems": 2
}Get reveal job
Get a reveal job's status and, once completed, the revealed contacts. Free.
Inputs
- Job ID
job_idtextRequired - The jobId from 'Reveal lead contacts' (it starts with rj_).
Outputs
completedAttext- When it finished (ISO 8601)
createdAttext- When it was submitted (ISO 8601)
creditsRefundednumber- Credits given back when it failed
errortext- Why the job failed
fieldslist- The contact fields asked for
jobIdtext- The job's id (rj_...)
jobTypetext- reveal or enrich
progressobject- How far the job has got
resultsobject- What was revealed, once completed
statustext- pending, processing, completed or failed
Example output
{
"completedAt": "2026-03-02T10:00:04.000Z",
"createdAt": "2026-03-02T10:00:00.000Z",
"creditsRefunded": null,
"error": null,
"fields": [
"email"
],
"jobId": "rj_a1b2c3d4e5f6g7h8",
"jobType": "enrich",
"progress": {
"processed": 1,
"total": 1
},
"results": {
"alreadyRevealed": 0,
"creditsRefunded": 0,
"creditsUsed": 10,
"newlyRevealed": 1,
"revealed": [
{
"companyName": "Stripe",
"domain": "stripe.com",
"emailAddress": "jane@stripe.com",
"firstName": "Jane",
"id": "enc_abc123def456",
"jobTitle": "VP of Engineering",
"lastName": "Doe",
"linkedinUrl": "https://www.linkedin.com/in/jane-doe",
"personalEmail": null
}
]
},
"status": "completed"
}List credit transactions
List credits spent, bought, adjusted and refunded, newest first, one page at a time. Free.
Inputs
- Type
transaction_typetext - Only this kind of transaction. Leave empty for all.One of:
deduction(Credits spent),topup(Top-ups),adjustment(Adjustments),refund(Refunds). - Page
pagenumber - Which page to return, from 1.At least 1.
- Page size
limitnumber - 1 to 100. Enrich's default is 50.From 1 to 100.
Outputs
paginationobject- Where this page sits
transactionslist- The transactions
Example output
{
"pagination": {
"limit": 50,
"page": 1,
"total": 1,
"totalPages": 1
},
"transactions": [
{
"amount": -10,
"balanceAfter": 90,
"createdAt": "2026-03-02T10:00:00.000Z",
"description": "Email finder",
"id": "txn_664f2b3c9a1e4d0012ab",
"metadata": {},
"organizationId": "org_664f2b3c9a1e4d0012ab",
"type": "deduction"
}
]
}List saved searches
List your saved Lead Finder searches and their filters. Free.
Inputs
None.
Outputs
countnumber- How many there are
searcheslist- The saved searches
Example output
{
"count": 1,
"searches": [
{
"createdAt": "2026-03-02T10:00:00.000Z",
"filters": {
"companyName": [
"Stripe"
],
"jobLevel": [
"VP",
"Director"
]
},
"id": "ss_664f2b3c9a1e4d0012abcd01",
"name": "Engineering leaders at Stripe",
"updatedAt": "2026-03-02T10:00:00.000Z"
}
]
}Reveal lead contacts
Reveal work and personal emails for up to 25 leads from 'Search leads', waiting for Enrich to finish. 10 credits a lead for each field; free again within 24 hours and refunded when nothing is on file.
Inputs
- Leads
lead_idslistRequired - Up to 25 lead ids from 'Search leads', or the search's results themselves.
- What to reveal
fieldslistRequired - Which contact details to reveal for each lead.One or more of:
email(Work email (10 credits a lead)),personalEmail(Personal email (10 credits a lead)).
Outputs
completedAttext- When it finished (ISO 8601)
createdAttext- When it was submitted (ISO 8601)
creditsRefundednumber- Credits given back when it failed
errortext- Why the job failed
fieldslist- The contact fields asked for
jobIdtext- The job's id (rj_...)
jobTypetext- reveal or enrich
progressobject- How far the job has got
resultsobject- What was revealed, once completed
statustext- pending, processing, completed or failed
Example output
{
"completedAt": "2026-03-02T10:00:04.000Z",
"createdAt": "2026-03-02T10:00:00.000Z",
"creditsRefunded": null,
"error": null,
"fields": [
"email"
],
"jobId": "rj_a1b2c3d4e5f6g7h8",
"jobType": "enrich",
"progress": {
"processed": 1,
"total": 1
},
"results": {
"alreadyRevealed": 0,
"creditsRefunded": 0,
"creditsUsed": 10,
"newlyRevealed": 1,
"revealed": [
{
"companyName": "Stripe",
"domain": "stripe.com",
"emailAddress": "jane@stripe.com",
"firstName": "Jane",
"id": "enc_abc123def456",
"jobTitle": "VP of Engineering",
"lastName": "Doe",
"linkedinUrl": "https://www.linkedin.com/in/jane-doe",
"personalEmail": null
}
]
},
"status": "completed"
}Save search
Save a set of Lead Finder filters under a name. Free.
Inputs
- Name
nametextRequired - A name for the search, up to 100 characters.
- Job titles
job_titleslist - Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
- Seniority
job_levelslist - Only people at these levels.One or more of:
C-Team,VP,Director,Manager,Staff,Other. - Department
job_functionslist - Only people in these departments.One or more of:
Advertising & Marketing,Art, Culture and Creative Professionals,Construction,Customer/Client Service,Education,Engineering,Finance & Accounting,General Business & Management,Healthcare & Human Services,Human Resources, and 12 more. - Company names
company_nameslist - Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
- Company name match
company_name_modetext - Match company names exactly, or any name containing them.One of:
exact(Exact name),contains(Name contains). - Company domains
domainslist - Company websites, such as stripe.com. URLs are cleaned up.
- Cities people live in
citieslist - City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
- Countries people live in
countrieslist - Only people in these countries. Up to 20.
- Industries
industrieslist - Only companies in these LinkedIn industries. Up to 20.
- Company headquarters countries
headquarters_countrieslist - Only companies headquartered in these countries. Up to 20.
- Fewest employees
employee_count_minnumber - Only companies with at least this many employees.At least 0.
- Most employees
employee_count_maxnumber - Only companies with at most this many employees.At least 0.
- LinkedIn headline words
person_headlineslist - Words in the person's LinkedIn headline. Up to 10.
- Skills
skillslist - Skills listed on the profile, matched exactly. Up to 25.
- Current job only
current_job_onlytrue/false - Match only the job people hold now, not past ones.
- More filters
more_filtersobject - Any other Lead Finder filters, named as Enrich's docs name them, such as {"revenueBuckets": ["$10M-$50M"]}. The fields before this one win where both are set.
Outputs
createdAttext- When it was saved (ISO 8601)
filtersobject- The Lead Finder filters, as Enrich names them
idtext- The saved search's id
nametext- Its name
updatedAttext- When it last changed (ISO 8601)
Example output
{
"createdAt": "2026-03-02T10:00:00.000Z",
"filters": {
"companyName": [
"Stripe"
],
"jobLevel": [
"VP",
"Director"
]
},
"id": "ss_664f2b3c9a1e4d0012abcd01",
"name": "Engineering leaders at Stripe",
"updatedAt": "2026-03-02T10:00:00.000Z"
}Search leads
Search Enrich's Lead Finder for people by job, company and place. Returns one page of leads without contact details; 'Reveal lead contacts' gets their emails. 50 free searches a month, then 1 credit a result past the first 75.
Inputs
- Job titles
job_titleslist - Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
- Seniority
job_levelslist - Only people at these levels.One or more of:
C-Team,VP,Director,Manager,Staff,Other. - Department
job_functionslist - Only people in these departments.One or more of:
Advertising & Marketing,Art, Culture and Creative Professionals,Construction,Customer/Client Service,Education,Engineering,Finance & Accounting,General Business & Management,Healthcare & Human Services,Human Resources, and 12 more. - Company names
company_nameslist - Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
- Company name match
company_name_modetext - Match company names exactly, or any name containing them.One of:
exact(Exact name),contains(Name contains). - Company domains
domainslist - Company websites, such as stripe.com. URLs are cleaned up.
- Cities people live in
citieslist - City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
- Countries people live in
countrieslist - Only people in these countries. Up to 20.
- Industries
industrieslist - Only companies in these LinkedIn industries. Up to 20.
- Company headquarters countries
headquarters_countrieslist - Only companies headquartered in these countries. Up to 20.
- Fewest employees
employee_count_minnumber - Only companies with at least this many employees.At least 0.
- Most employees
employee_count_maxnumber - Only companies with at most this many employees.At least 0.
- LinkedIn headline words
person_headlineslist - Words in the person's LinkedIn headline. Up to 10.
- Skills
skillslist - Skills listed on the profile, matched exactly. Up to 25.
- Current job only
current_job_onlytrue/false - Match only the job people hold now, not past ones.
- More filters
more_filtersobject - Any other Lead Finder filters, named as Enrich's docs name them, such as {"revenueBuckets": ["$10M-$50M"]}. The fields before this one win where both are set.
- Leave out job titles
exclude_job_titleslist - Leave out anyone whose job title contains these words. Up to 25.
- Page
pagenumber - Which page to return, from 1.At least 1.
- Page size
page_sizenumber - Leads per page, 1 to 100. Enrich's default is 25.From 1 to 100.
Outputs
metaobject- What the search cost, and the free searches left this month
paginationobject- Where this page sits
resultslist- The matching leads
Example output
{
"meta": {
"alreadyCharged": false,
"creditsRequired": 0,
"creditsUsed": 0,
"freeQueriesRemaining": 49,
"freeQueryLimit": 50,
"freeResultLimit": 75,
"freeResults": 1,
"isFreeQuery": true,
"paidResults": 0,
"requestId": "req_664f2b3c9a1e4d0012abcdf2",
"resultsWithheld": 0,
"searchCreditRate": 1
},
"pagination": {
"hasMore": false,
"isApproximate": false,
"page": 1,
"pageSize": 25,
"searchedTotalResult": 1,
"totalPages": 1,
"totalResults": 1
},
"results": [
{
"city": "San Francisco",
"companyHeadline": "Financial infrastructure for the internet",
"companyName": "Stripe",
"countryName": "United States",
"domain": "stripe.com",
"emailDomain": "stripe.com",
"employeeCount": 8000,
"employeeOnLinkedinGrowthRateOrg": 12,
"firstName": "Jane",
"foundedOn": "2010",
"headquartersCity": "San Francisco",
"headquartersCountry": "United States",
"headquartersState": "California",
"id": "enc_abc123def456",
"industryNaicsDescription": "Data Processing, Hosting, and Related Services",
"industrySicDescription": "Computer Processing & Data Preparation",
"jobFunction": "Engineering",
"jobLevel": "VP",
"jobTitle": "VP of Engineering",
"lastFundingDateOrg": "2023-03-15",
"lastFundingTypeOrg": "Series I",
"lastName": "Doe",
"linkedinConnectionsCount": 500,
"linkedinHeadline": "VP of Engineering at Stripe",
"linkedinUrl": "https://www.linkedin.com/in/jane-doe",
"logoUrl": null,
"logoUrlOrg": null,
"orgLinkedinUrl": "https://linkedin.com/company/stripe",
"revenue": "$1B+",
"skills": "Python, Distributed Systems",
"specialties": "Payments, Financial Infrastructure",
"stateName": "California",
"totalFundingAmountOrg": 8700000000,
"totalMonthlyTrafficOrg": 5000000
}
]
}Suggest cities
Find the city names Lead Finder knows that match some text, to use in a search's 'Cities people live in'. Free.
Inputs
- Text to match
querytextRequired - At least 2 characters of the city's name.
- Which cities
city_fieldtext - Cities people live in, or where companies are based.One of:
city(Where people live (default)),headquartersCity(Where companies have their headquarters). - How many
limitnumber - 1 to 20. Enrich's default is 20.From 1 to 20.
Outputs
valueslist- The suggested names, best match first
Example output
{
"values": [
"San Francisco",
"San Fernando"
]
}Suggest company names
Find the company names Lead Finder knows that match some text, to use in a search's 'Company names'. Free.
Inputs
- Text to match
querytextRequired - At least 2 characters of the company's name.
- How many
limitnumber - 1 to 50. Enrich's default is 20.From 1 to 50.
Outputs
valueslist- The suggested names, best match first
Example output
{
"values": [
"Stripe",
"Stripe Partners"
]
}Validate email
Check whether an email address can receive mail: valid, invalid or risky, with the mail provider and whether the domain accepts every address. 1 credit, none when risky.
Inputs
- Email address
emailtextRequired - The email address, such as jane@example.com.
Outputs
confidencetext- definitive, high, medium, low, temporary or none
emailtext- The address checked
hasSEGtrue/false- Whether a secure email gateway screens the domain's mail
isCatchAlltrue/false- Whether the domain accepts every address
isFederatedtrue/false- Whether the domain signs in through another provider
messagetext- Enrich's explanation
metaobject- The request id, and the credits this call used and has left
providertext- GOOGLE, MICROSOFT or SMTP
resulttext- valid, invalid or risky
segProvidertext- The gateway, such as mimecast
Example output
{
"confidence": "high",
"email": "jane@example.com",
"hasSEG": false,
"isCatchAll": false,
"isFederated": false,
"message": "Mailbox exists",
"meta": {
"creditsRemaining": 89,
"creditsUsed": 1,
"processingTimeMs": 840,
"requestId": "req_664f2b3c9a1e4d0012abcdef"
},
"provider": "GOOGLE",
"result": "valid",
"segProvider": null
}Validate emails in bulk
Queue up to 1,000 email addresses for validation. Repeats are dropped. Returns a batch ID for 'Get email batch results'. 1 credit an address, reserved now.
Inputs
- Email addresses
emailslistRequired - The addresses to check, one per entry. Up to 1,000.
Outputs
batchIdtext- The batch's id
duplicatesRemovednumber- Repeats dropped
itemCountnumber- Addresses queued
metaobject- The request id and the credits reserved for the batch
originalCountnumber- Addresses sent
statustext- Usually queued
Example output
{
"batchId": "batch_664f2b3c9a1e4d0012ab",
"duplicatesRemoved": 0,
"itemCount": 2,
"meta": {
"creditsPerItem": 1,
"creditsReserved": 2,
"estimatedCredits": 2,
"requestId": "req_664f2b3c9a1e4d0012abcdf0"
},
"originalCount": 2,
"status": "queued"
}