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

ActionWhat it does
Count leadsCount the Lead Finder leads matching a set of filters, to size a search before running it.
Delete saved searchDelete one of your saved Lead Finder searches.
Find best-fit people at a companyRank the people at a company against your ideal customer profile: titles, seniority, departments, skills and place.
Find company employeesList people who work at a company, from its LinkedIn page, filtered by place, seniority and department.
Find person by emailLook up the professional profile behind an email address: name, headline, company, location, jobs and schools.
Find personal emailFind a personal email address from someone's LinkedIn profile.
Find work emailFind someone's work email from their name and company domain.
Get credit balanceGet your Enrich organization's credit balance.
Get email batch resultsGet one page of a validation batch's results, optionally waiting for the batch to finish first.
Get email batch statusGet a validation batch's status (queued, processing, completed or failed) and progress.
Get reveal jobGet a reveal job's status and, once completed, the revealed contacts.
List credit transactionsList credits spent, bought, adjusted and refunded, newest first, one page at a time.
List saved searchesList your saved Lead Finder searches and their filters.
Reveal lead contactsReveal work and personal emails for up to 25 leads from 'Search leads', waiting for Enrich to finish.
Save searchSave a set of Lead Finder filters under a name.
Search leadsSearch Enrich's Lead Finder for people by job, company and place.
Suggest citiesFind the city names Lead Finder knows that match some text, to use in a search's 'Cities people live in'.
Suggest company namesFind the company names Lead Finder knows that match some text, to use in a search's 'Company names'.
Validate emailCheck 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 bulkQueue 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 titlesjob_titleslist
Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
Seniorityjob_levelslist
Only people at these levels.One or more of: C-Team, VP, Director, Manager, Staff, Other.
Departmentjob_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 namescompany_nameslist
Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
Company name matchcompany_name_modetext
Match company names exactly, or any name containing them.One of: exact (Exact name), contains (Name contains).
Company domainsdomainslist
Company websites, such as stripe.com. URLs are cleaned up.
Cities people live incitieslist
City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
Countries people live incountrieslist
Only people in these countries. Up to 20.
Industriesindustrieslist
Only companies in these LinkedIn industries. Up to 20.
Company headquarters countriesheadquarters_countrieslist
Only companies headquartered in these countries. Up to 20.
Fewest employeesemployee_count_minnumber
Only companies with at least this many employees.At least 0.
Most employeesemployee_count_maxnumber
Only companies with at most this many employees.At least 0.
LinkedIn headline wordsperson_headlineslist
Words in the person's LinkedIn headline. Up to 10.
Skillsskillslist
Skills listed on the profile, matched exactly. Up to 25.
Current job onlycurrent_job_onlytrue/false
Match only the job people hold now, not past ones.
More filtersmore_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 titlesexclude_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 one of your saved Lead Finder searches. Free.

Inputs

Saved search IDsearch_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 pagecompany_linkedin_urltextRequired
The company's LinkedIn page, such as https://www.linkedin.com/company/stripe, or just its name in that address (stripe).
Job titlesinclude_titleslist
Titles to look for, such as Head of Sales.
Leave out job titlesexclude_titleslist
Titles to leave out, such as Intern.
Seniorityjob_levelslist
Levels such as Owner, Founder, C-Level, Partner, VP, Director, Manager, Senior, Staff, Entry or Intern.
Departmentsjob_functionslist
Departments such as Engineering, Marketing or Sales.
Skillsskillslist
Skills that raise a person's score.
Locationslocationslist
Two-letter country codes (US, DE), continents (NORTH_AMERICA, EUROPE) or WORLD.
Match titles in headlinesinclude_headline_searchtrue/false
Also look for the job titles in LinkedIn headlines.
Most peoplemax_resultsnumber
1 to 100, each costing a credit. Enrich's default is 25.From 1 to 100.
Lowest scoremin_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 pagecompany_linkedin_urltextRequired
The company's LinkedIn page, such as https://www.linkedin.com/company/stripe, or just its name in that address (stripe).
Countriescountrieslist
Country names, such as United States. Up to 50.
Continentscontinentslist
Continent names, such as Europe.
Sales regionssales_regionslist
Sales regions, such as EMEA.
Seniorityjob_levelslist
Seniority levels, such as Director.
Departmentsjob_functionslist
Departments, such as Engineering.
Most peoplemax_resultsnumber
1 to 100, each costing a credit. Enrich's default is 10.From 1 to 100.
Pagepagenumber
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 addressemailtextRequired
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 profilelinkedin_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 namefirst_nametextRequired
The person's first name.
Last namelast_nametextRequired
The person's last name.
Company domaindomaintextRequired
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 IDbatch_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.
Pagepagenumber
Which page to return, from 1.At least 1.
Page sizelimitnumber
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 IDbatch_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 IDjob_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

Typetransaction_typetext
Only this kind of transaction. Leave empty for all.One of: deduction (Credits spent), topup (Top-ups), adjustment (Adjustments), refund (Refunds).
Pagepagenumber
Which page to return, from 1.At least 1.
Page sizelimitnumber
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

Leadslead_idslistRequired
Up to 25 lead ids from 'Search leads', or the search's results themselves.
What to revealfieldslistRequired
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 a set of Lead Finder filters under a name. Free.

Inputs

NamenametextRequired
A name for the search, up to 100 characters.
Job titlesjob_titleslist
Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
Seniorityjob_levelslist
Only people at these levels.One or more of: C-Team, VP, Director, Manager, Staff, Other.
Departmentjob_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 namescompany_nameslist
Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
Company name matchcompany_name_modetext
Match company names exactly, or any name containing them.One of: exact (Exact name), contains (Name contains).
Company domainsdomainslist
Company websites, such as stripe.com. URLs are cleaned up.
Cities people live incitieslist
City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
Countries people live incountrieslist
Only people in these countries. Up to 20.
Industriesindustrieslist
Only companies in these LinkedIn industries. Up to 20.
Company headquarters countriesheadquarters_countrieslist
Only companies headquartered in these countries. Up to 20.
Fewest employeesemployee_count_minnumber
Only companies with at least this many employees.At least 0.
Most employeesemployee_count_maxnumber
Only companies with at most this many employees.At least 0.
LinkedIn headline wordsperson_headlineslist
Words in the person's LinkedIn headline. Up to 10.
Skillsskillslist
Skills listed on the profile, matched exactly. Up to 25.
Current job onlycurrent_job_onlytrue/false
Match only the job people hold now, not past ones.
More filtersmore_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 titlesjob_titleslist
Words in the job title, matched anywhere and ignoring case ("sales" finds "VP of Sales"). Up to 25.
Seniorityjob_levelslist
Only people at these levels.One or more of: C-Team, VP, Director, Manager, Staff, Other.
Departmentjob_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 namescompany_nameslist
Companies people work at, as Enrich names them. 'Suggest company names' finds the exact spelling. Up to 25.
Company name matchcompany_name_modetext
Match company names exactly, or any name containing them.One of: exact (Exact name), contains (Name contains).
Company domainsdomainslist
Company websites, such as stripe.com. URLs are cleaned up.
Cities people live incitieslist
City names, such as London. 'Suggest cities' finds the spelling Enrich uses. Up to 20.
Countries people live incountrieslist
Only people in these countries. Up to 20.
Industriesindustrieslist
Only companies in these LinkedIn industries. Up to 20.
Company headquarters countriesheadquarters_countrieslist
Only companies headquartered in these countries. Up to 20.
Fewest employeesemployee_count_minnumber
Only companies with at least this many employees.At least 0.
Most employeesemployee_count_maxnumber
Only companies with at most this many employees.At least 0.
LinkedIn headline wordsperson_headlineslist
Words in the person's LinkedIn headline. Up to 10.
Skillsskillslist
Skills listed on the profile, matched exactly. Up to 25.
Current job onlycurrent_job_onlytrue/false
Match only the job people hold now, not past ones.
More filtersmore_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 titlesexclude_job_titleslist
Leave out anyone whose job title contains these words. Up to 25.
Pagepagenumber
Which page to return, from 1.At least 1.
Page sizepage_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 matchquerytextRequired
At least 2 characters of the city's name.
Which citiescity_fieldtext
Cities people live in, or where companies are based.One of: city (Where people live (default)), headquartersCity (Where companies have their headquarters).
How manylimitnumber
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 matchquerytextRequired
At least 2 characters of the company's name.
How manylimitnumber
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 addressemailtextRequired
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 addressesemailslistRequired
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"
}

On this page