B2B People Search API - Email and Mobile Number Enrichment

Search a B2B database of people and companies by job title, seniority, department, country, industry, headcount, revenue, technologies and funding, then enrich the results in bulk with verified work email addresses, mobile phone numbers and job history. One flat row per person or company.

What this actor does

• Separates finding people from reaching them. Search tells you who exists and what they do; enrichment appends the addresses and phone numbers. They draw on different credit pools, so searching first and enriching only the people who survive your filters is what keeps a list cheap.
• Enriches in real batches. The provider takes up to 10,000 people or 500 companies in a single job, so enriching a large list is a handful of jobs rather than one request per person. The actor submits a batch, waits for it, reports the percentage complete as it goes, and writes the records out when it finishes.
• Pairs answers back by identifier, never by position. An enrichment can return fewer records than were submitted. Every record carries the identifier it was sent with, so a dropped record leaves a visible gap instead of shifting one person's email address onto the next person's row.
• Lists the provider's own filter vocabulary. Seniorities, departments, industries and technology categories are values this provider defines and updates. Run the filters mode once and every accepted value lands in a dataset, so your filters use the provider's spelling rather than your guess at it.
• Filters on both halves of the picture. Person filters cover title, exact title, seniority, department, country, state, previous employer and how recently the person changed job. Company filters cover domain, name, industry, headcount, revenue, technologies, technology categories, keywords, NAICS code, founding year and department headcount, each with an exclude list.
• Caps how many people come from one company. A single large employer can otherwise fill an entire result set, so results per company is a first class filter.
• Returns ranked contact details, not just the first one. Addresses arrive with a type and a validation status, mobile numbers with a confidence score. The best of each is lifted into a leading column and the full ranked lists are kept, because the second address is often the one that works when the first bounces.
• Never charges for a miss. Only rows carrying a resolved person or company are billed.

Input

Field	What it does
mode	People search, company search, people enrichment, company enrichment, filters or credits.
jobTitles, exactJobTitles	Loose or literal title matching.
seniorities, departments	Provider vocabulary, listed by the filters mode.
personCountries, personStates	Where the person is, as us or us:CA.
previousCompanyDomains	People who used to work somewhere.
jobChangePeriodInDays	Only people who changed job recently.
peoplePerCompany	Cap results from any one employer.
companyDomains, companyNames, companyCountries	Which companies to search or enrich.
industries, naicsCodes	Industry filters, provider labels or official codes.
employeeCountFrom/To, revenueFrom/To, yearFoundedFrom/To	Firmographic ranges.
technologies, technologyCategories	Technographic filters, with exclusions.
departmentSizes	Named department headcount, as sales:10-50.
profileUrls, fullNames	Who to enrich.
includeEmail, includeMobile, includeProfileUrl, includeJobHistory	What enrichment returns.
acceptedEmailType	Professional or personal addresses.
skipMobileWithoutEmail	Do not spend a mobile credit on a thin record.
pageSize, batchSize, jobTimeoutSeconds	Paging and batching behaviour.
requestsPerMinute	Pace the run under your plan's rate limit.
skipNotFound	Leave unresolved inputs out of the dataset.
maxResults	Hard cap on rows, and therefore on spend and run time.
apiKey	Your own API key. Stored as a secret.

Example output

{
  "found": true,
  "mode": "peopleEnrich",
  "query": "https://www.linkedin.com/in/example",
  "firstName": "Jane",
  "lastName": "Doe",
  "fullName": "Jane Doe",
  "jobTitle": "Head of Sales",
  "seniorities": ["Director"],
  "departments": ["Sales"],
  "email": "jane.doe@example.com",
  "emailType": "professional",
  "emailValidationStatus": "VALID",
  "mobilePhone": "+14155550123",
  "mobileConfidence": 0.92,
  "linkedinUrl": "https://www.linkedin.com/in/example",
  "city": "San Francisco",
  "state": "California",
  "country": "United States",
  "companyName": "Example Inc",
  "companyDomain": "example.com",
  "jobHistory": [
    {
      "companyName": "Example Inc",
      "jobTitle": "Head of Sales",
      "startDate": "2023-02-01",
      "endDate": null
    }
  ],
  "recordStatus": "COMPLETED",
  "error": null,
  "raw": { }
}

Frequently asked questions

What is a B2B people search API?

A B2B people search API is a query interface over a database of working professionals and their employers. You describe the people you want with filters such as job title, seniority, department, country, and the size, industry, revenue or technology stack of the company they work for, and the API returns everyone who matches. This actor exposes those filters as actor input and writes one row per person to a dataset. Contact details are a separate step: search returns who someone is and where they work, and enrichment returns how to reach them.

How do I get verified work email addresses and mobile numbers?

Run the people enrichment mode with a list of profile URLs, or with full names paired with a company domain. Turn on includeEmail for work addresses and includeMobile for mobile numbers. Each address comes back with a type and a validation status, and each mobile number with a confidence score, so you can drop anything below your own threshold before sending. Email and mobile draw on separate credit pools, which is why mobile is off by default: turn it on only when someone will actually dial.

How many records can I enrich in one run?

The provider accepts up to 10,000 people or 500 companies per enrichment job, and the actor batches automatically up to whichever ceiling applies to the mode you are running. Larger batches are cheaper in requests and slower to come back, so the actor polls with a widening interval and reports the percentage complete rather than going quiet. Set batchSize smaller if you would rather see rows land sooner, and raise jobTimeoutSeconds if you are enriching tens of thousands of records.

Why do my seniority or industry filters return nothing?

Because those filters take the provider's own vocabulary, not free text. A value the provider does not recognise matches nothing rather than being ignored. Run the filters mode once: it writes every accepted seniority, department, industry, technology category, headcount band and revenue band to the dataset, one row per value. Copy the spellings from there. This actor deliberately does not hard code those lists, because the provider updates them and a stale dropdown would start rejecting values that are still valid.

What is the difference between job titles and exact job titles?

jobTitles is matched loosely: the provider expands it by acronym and by meaning, so "VP Sales" also reaches "Vice President of Sales" and similar variants. That is usually what you want, since title text is written differently at every company. exactJobTitles matches the literal string only. Use it when the loose match is pulling in adjacent roles, for example when "head of sales" keeps returning sales operations and sales enablement people you do not sell to.

Can I find companies rather than people?

Yes. Company search takes the firmographic and technographic half of the filter set on its own and returns accounts with headcount, revenue, industries and NAICS classification. Company enrichment goes the other way: give it domains you already have and it appends the description, headcount, revenue, industry, founding year, headquarters, social profiles, parent organisation, stock listing and the full funding round history, with the most recent round lifted into its own columns. A common two step run is to search for accounts, take the domains out of the dataset, and feed them back in as the company domain filter on a people search.

Do I need my own API key?

Yes. This actor is bring your own key: it calls the people and company data API with credentials from your own account, so your plan governs your credits, your rate limit and your data rights. Put the key in the apiKey input, where it is stored as a secret, or supply it as the DATA_API_KEY environment secret. The actor's own charge is separate and is per row resolved, and rows that resolved to nothing are never charged for.

Keyword map

B2B people search API, contact enrichment API, work email finder, mobile phone enrichment, bulk lead enrichment, company search API, firmographic filters, technographic filters, job change signals, NAICS industry search, sales prospecting data, ICP account list building.