Search leads

Search across people, companies, and insights dimensions with comprehensive filters. Returns combined person + org + insights data, including full names.

Free searches:

50 free searches per account per calendar month (UTC). A search is a unique filter combination — paging through it or running it again does not use another free search. All workspaces owned by the same user share these 50.

The first 75 results of a free search are free, at any page size. Each result after the 75th costs 1 credit.

A filter combination that was one of your 50 free searches stays free (first 75 results) for the rest of the month.

After the 50 free searches: every result of a new search costs 1 credit.

Billing details:

The same page (same filters, page and pageSize) is not charged again within 24 hours.

If the billed part of a page can't be paid for, the response is 402 Payment Required — unless part of the page is free, in which case the free results are returned and meta.resultsWithheld says how many were held back.

Every response reports meta.creditsUsed, meta.isFreeQuery and meta.freeQueriesRemaining. Use Count matching leads (free) to size a search first.

Accounts that don't qualify for the free tier (for example, signed up with a temporary email address) pay from the first result.

Results can be paged up to 500,000 deep: (page - 1) × pageSize must be under 500,000.

Results include preview fields only. Use the Reveal or Enrich endpoints to get email and phone.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

curl --location 'https://dev.enrich.so/api/v3/lead-finder/search' \ --header 'x-api-key: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "filters": { "firstName": "string", "lastName": "string", "middleName": "string", "city": "string", "stateName": "string", "stateCode": "string", "countryName": "string", "countryCode": "string", "continent": "string", "countryRegion": "string", "linkedinUrl": "string", "linkedinHeadline": "string", "personHeadline": "string", "companyHeadline": "string", "linkedinIndustry": "string", "logoUrl": "string", "emailDomain": "string", "emailAddress": "string", "jobTitle": "string", "jobFunction": "string", "jobLevel": "string", "jobDescription": "string", "jobLocationCity": "string", "jobLocationState": "string", "jobLocationCountry": "string", "jobIsCurrent": true, "jobStartDate": "string", "jobCount": 0, "companyName": "string", "companyNameMode": "exact", "persona": "string", "languages": "string", "skills": "string", "certifications": "string", "patents": "string", "publications": "string", "websites": "string", "education": "string", "phone": "string", "cellphone": "string", "orgName": "string", "domain": "string", "aboutUs": "string", "companyEntityType": "string", "companyLegalType": "string", "employeeCount": 0, "employeeCountMax": 0, "employeeCountMin": 0, "foundedOn": 0, "headquartersCity": "string", "headquartersState": "string", "headquartersCountry": "string", "industrySicCode": "string", "industrySicDescription": "string", "industryNaicsCode": "string", "industryNaicsDescription": "string", "orgLinkedinUrl": "string", "locationCity": "string", "locationState": "string", "locationCountry": "string", "revenueMax": 0, "revenueMin": 0, "revenueBuckets": "string", "specialties": "string", "crmTechOrg": "string", "marketingAutomationTechOrg": "string", "abmTechOrg": "string", "salesAutomationTechOrg": "string", "analyticsTechOrg": "string", "cmsTechOrg": "string", "martechCategoriesOrg": "string", "conversationIntelligenceTechOrg": "string", "cloudProviderTechOrg": "string", "emailHostingTechOrg": "string", "emailSecurityTechOrg": "string", "applicationSecurityTechOrg": "string", "cloudSecurityTechOrg": "string", "developmentTechOrg": "string", "eCommercePlatformTechOrg": "string", "erpTechOrg": "string", "hasMobileAppOrg": true, "hasWebAppOrg": true, "hasCisoOrg": true, "hasCioOrg": true, "locationCountOrg": 0, "isLinkedinUrlClaimedOrg": true, "marketingRoleCountOrg": 0, "salesRoleCountOrg": 0, "operationsRoleCountOrg": 0, "businessDevelopmentRoleCountOrg": 0, "customerSuccessRoleCountOrg": 0, "itRoleCountOrg": 0, "grcRoleCountOrg": 0, "securityRoleCountOrg": 0, "devopsRoleCountOrg": 0, "networkInfrastructureRoleCountOrg": 0, "mobileDevRoleCountOrg": 0, "iosDevRoleCountOrg": 0, "androidDevRoleCountOrg": 0, "engineerRoleCountOrg": 0, "qaRoleCountOrg": 0, "marketingOpenRolesCountOrg": 0, "operationsOpenRolesCountOrg": 0, "salesOpenRolesCountOrg": 0, "accountExecutiveOpenRolesCountOrg": 0, "customerSuccessOpenRolesCountOrg": 0, "demandGenerationOpenRolesCountOrg": 0, "businessDevelopmentOpenRolesCountOrg": 0, "itOpenRolesCountOrg": 0, "securityOpenRolesCountOrg": 0, "grcOpenRolesCountOrg": 0, "devopsOpenRolesCountOrg": 0, "networkInfrastructureOpenRolesCountOrg": 0, "monthlyOrganicTrafficOrg": 0, "monthlyPaidTrafficOrg": 0, "totalMonthlyTrafficOrg": 0, "monthlyGoogleAdspendOrg": 0, "employeeOnLinkedinGrowthRateOrg": 0, "isWebsiteForSaleOrg": true, "topAppleappstoreUrlOrg": "string", "topAppstoreRatingOrg": 0, "topAppstoreReviewCountOrg": 0, "lastAppstoreUpdateOrg": "string", "appstoreUpdateCountOrg": 0, "appstoreAppCategoryOrg": "string", "topPlaystoreUrlOrg": "string", "topPlaystoreRatingOrg": 0, "topPlaystoreReviewCountOrg": 0, "lastPlaystoreUpdateOrg": "string", "playstoreDownloadCountOrg": 0, "playstoreAppCategoryOrg": "string", "totalReviewsOrg": 0, "lastFundingDateOrg": "string", "lastFundingAmountOrg": 0, "leadInvestorsOrg": "string", "lastFundingTypeOrg": "string", "fundingRoundNumberOfInvestorsOrg": 0, "totalFundingAmountOrg": 0 }, "excludeFilters": { "personHeadline": "string", "companyHeadline": "string", "aboutUs": "string", "domain": "string", "jobTitle": "string" }, "page": 1, "pageSize": 25 }'

{ "success": true, "data": { "results": [ { "id": "enc_abc123def456", "firstName": "Sarah", "lastName": "Chen", "logoUrl": "https://media.licdn.com/dms/image/stripe-logo.jpg", "emailDomain": "stripe.com", "linkedinUrl": "https://linkedin.com/in/sarahc", "linkedinHeadline": "VP of Engineering at Stripe", "jobTitle": "VP of Engineering", "jobFunction": "Engineering", "jobLevel": "VP", "companyName": "Stripe", "skills": "Python, Distributed Systems, Cloud Architecture", "city": "San Francisco", "stateName": "California", "countryName": "United States", "domain": "stripe.com", "orgLinkedinUrl": "https://linkedin.com/company/stripe", "employeeCount": 8000, "industrySicDescription": "Computer Processing & Data Preparation", "industryNaicsDescription": "Data Processing, Hosting, and Related Services", "revenue": "$1B+", "specialties": "Payments, Financial Infrastructure", "foundedOn": "2010", "headquartersCity": "San Francisco", "headquartersState": "California", "headquartersCountry": "United States", "employeeOnLinkedinGrowthRateOrg": 12, "totalMonthlyTrafficOrg": 5000000, "totalFundingAmountOrg": 8700000000, "lastFundingTypeOrg": "Series I", "lastFundingDateOrg": "2023-03-15" } ], "pagination": { "page": 1, "pageSize": 25, "totalResults": 1842, "totalPages": 74, "hasMore": true, "searchedTotalResult": 1842 } }, "meta": { "requestId": "req_664f2b3c9a1e4d0012abcdef", "creditsUsed": 0, "searchCreditRate": 1, "isFreeQuery": true, "freeQueriesRemaining": 49, "freeQueryLimit": 50, "freeResultLimit": 75, "freeResults": 25, "paidResults": 0, "alreadyCharged": false } }

Request

Responses