Count matching leads

POST

/lead-finder/count

Get the total count of leads matching your filters. This endpoint is free and does not consume credits.

Requires approved Lead Finder access. Returns 403 if your team has not been approved.

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

Responses

🟢200OK

application/json

Count returned successfully

Headers

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Too Many Requests

🟠429Internal Server Error

🔴500Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.enrich.so/api/v3/lead-finder/count' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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": {
        "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
    }
}'

Response Example

200 - Success

{
    "success": true,
    "data": {
        "count": 18420,
        "searchType": "unified"
    },
    "meta": {
        "requestId": "req_664f2b3c9a1e4d0012abcdf0"
    }
}

Modified at 2026-03-19 14:24:59

Export leads to CSV (async)

Reveal contact info