Count matching people
See how many people match your filters before you pay for any profiles.
Takes the same filters as POST /people/search, minus pagination.
Costs 1 credit per call, however large the audience — sizing an audience of 40,000 people still costs 1. credits_charged on the response says what you paid.
Request
- Base URL: https://api.scalelist.com
- URL: https://api.scalelist.com/api/v1/people/count
- Auth: API key in header x-api-key
Request body
Job titles to match (OR logic). Free text, e.g. ["CTO", "VP of Engineering"].
Functional areas (OR logic). Canonical values: Operations, Business Development, Sales, Education, Engineering, Healthcare Services, Information Technology, Administrative, Arts and Design, Customer Success and Support, Finance, Community and Social Services, Media and Communication, Accounting, Marketing, Human Resources, Research, Program and Project Management, Legal, Military and Protective Services, Consulting, Entrepreneurship, Real Estate, Quality Assurance, Purchasing, Product Management, Leadership.
Career levels (OR logic). Canonical values: Owner / Founder, CXO, Partner, VP, Head, Director, Manager, Senior, Entry, Intern.
Industries (OR logic). Free text; canonical Scalelist values recommended, e.g. Defense & Space, Computer Hardware, Computer Software, Computer Networking, Internet, Semiconductors, ...
Only people whose current role started in roughly the last 3 months. High-intent buying signal.
Only people with at least this many LinkedIn followers.
A single free-text term matched anywhere on the profile. To match several terms with OR logic, use keywords (plural) instead.
Free-text keywords, OR logic: a person matches if ANY term appears on their profile.
Free-text keywords to exclude: a person is dropped if any term appears on their profile.
Person-level buying signals from their own profile badges, e.g. ["hiring"].
Skills listed on the profile (OR logic), e.g. ["Salesforce", "Python"]. Search results do not show skills.
Languages the person speaks (OR logic), e.g. ["French", "German"].
Schools or universities attended (OR logic), e.g. ["Stanford", "HEC Paris"].
Certifications held (OR logic), e.g. ["PMP"]. Search results do not show certifications.
Company names (OR logic), e.g. ["Salesforce", "HubSpot"].
Company domains (OR logic), e.g. ["stripe.com"].
Companies the person previously worked at, by name (OR logic). With past_job_titles / past_seniority, all must hold for the SAME past role.
Job titles held in a past role (OR logic), e.g. ["Founder"]. With past_companies / past_seniority, all must hold for the SAME past role.
Career level of a past role (OR logic). One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training.
Country where the current employer is headquartered (OR logic). Full English name or ISO alpha-3 code, e.g. ["Germany", "USA"].
Company category filter, e.g. ["public company"] or ["non-profit"] (OR logic).
Job titles to exclude from results.
Company names to exclude from results.
Company websites to exclude from results, e.g. ["stripe.com"].
Industries to exclude (current employer). Resolved like industries; a word with no matching industry is refused with 422.
Career levels to exclude (current role). One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training.
Job functions to exclude (current role). Resolved like job_functions; a value with no matching function is refused with 422.
Drop anyone who previously worked at any of these companies, by name.
Drop anyone who held any of these job titles in a past role.
Drop anyone who held any of these career levels in a past role. One of: Owner / Partner, CXO, Vice President, Director, Experienced Manager, Entry Level Manager, Strategic, Senior, Entry Level, In Training.
Drop people whose current employer is headquartered in any of these countries. Full English name or ISO alpha-3 code.
Drop anyone who lists any of these skills.
Drop anyone who lists any of these languages.
Drop anyone who attended any of these schools.
Drop anyone who holds any of these certifications.
Response
Default Response
Changes
No recorded changes to this operation across all 2 revisions of this API.