People Search

Search for people

Build an audience: find people by job title, seniority, industry, location, company and more.

At least one filter is required. Page through results with page.

How filters combine. Values inside one list are OR; separate fields are AND. So industries: ["Banking", "Insurance"] matches either, and adding seniority narrows that set rather than widening it. Locations behave the same way across city, state and country: [{city: "Paris"}, {country: "Germany"}] means Paris or Germany, never both at once.

1 credit per profile returned, up to 100 per page. Page size is capped to your remaining balance, so 20 credits returns at most 20 profiles.

Tip: size your audience first with POST /people/count.

post/api/v1/people/search

Request

  • Base URL: https://api.scalelist.com
  • URL: https://api.scalelist.com/api/v1/people/search
  • Auth: API key in header x-api-key

Request body

job_titlesstring[]

Job titles to match (OR logic). Free text, e.g. ["CTO", "VP of Engineering"].

job_functionsstring[]

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.

senioritystring[]

Career levels (OR logic). Canonical values: Owner / Founder, CXO, Partner, VP, Head, Director, Manager, Senior, Entry, Intern.

industriesstring[]

Industries (OR logic). Free text; canonical Scalelist values recommended, e.g. Defense & Space, Computer Hardware, Computer Software, Computer Networking, Internet, Semiconductors, ...

recently_changed_jobsboolean

Only people whose current role started in roughly the last 3 months. High-intent buying signal.

min_followersinteger

Only people with at least this many LinkedIn followers.

keywordstring

A single free-text term matched anywhere on the profile. To match several terms with OR logic, use keywords (plural) instead.

keywordsstring[]

Free-text keywords, OR logic: a person matches if ANY term appears on their profile.

exclude_keywordsstring[]

Free-text keywords to exclude: a person is dropped if any term appears on their profile.

open_tostring[]

Person-level buying signals from their own profile badges, e.g. ["hiring"].

skillsstring[]

Skills listed on the profile (OR logic), e.g. ["Salesforce", "Python"]. Search results do not show skills.

languagesstring[]

Languages the person speaks (OR logic), e.g. ["French", "German"].

schoolsstring[]

Schools or universities attended (OR logic), e.g. ["Stanford", "HEC Paris"].

certificationsstring[]

Certifications held (OR logic), e.g. ["PMP"]. Search results do not show certifications.

companiesstring[]

Company names (OR logic), e.g. ["Salesforce", "HubSpot"].

company_domainsstring[]

Company domains (OR logic), e.g. ["stripe.com"].

past_companiesstring[]

Companies the person previously worked at, by name (OR logic). With past_job_titles / past_seniority, all must hold for the SAME past role.

past_job_titlesstring[]

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.

past_senioritystring[]

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.

company_hq_countriesstring[]

Country where the current employer is headquartered (OR logic). Full English name or ISO alpha-3 code, e.g. ["Germany", "USA"].

company_typestring[]

Company category filter, e.g. ["public company"] or ["non-profit"] (OR logic).

exclude_job_titlesstring[]

Job titles to exclude from results.

exclude_companiesstring[]

Company names to exclude from results.

exclude_company_domainsstring[]

Company websites to exclude from results, e.g. ["stripe.com"].

exclude_industriesstring[]

Industries to exclude (current employer). Resolved like industries; a word with no matching industry is refused with 422.

exclude_senioritystring[]

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.

exclude_job_functionsstring[]

Job functions to exclude (current role). Resolved like job_functions; a value with no matching function is refused with 422.

exclude_past_companiesstring[]

Drop anyone who previously worked at any of these companies, by name.

exclude_past_job_titlesstring[]

Drop anyone who held any of these job titles in a past role.

exclude_past_senioritystring[]

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.

exclude_company_hq_countriesstring[]

Drop people whose current employer is headquartered in any of these countries. Full English name or ISO alpha-3 code.

exclude_skillsstring[]

Drop anyone who lists any of these skills.

exclude_languagesstring[]

Drop anyone who lists any of these languages.

exclude_schoolsstring[]

Drop anyone who attended any of these schools.

exclude_certificationsstring[]

Drop anyone who holds any of these certifications.

pageinteger
page_sizeinteger

Profiles per page (max 100). Billed 1 credit per profile returned.

offsetinteger

Absolute row offset for the window; overrides page when set. Exactly [offset, offset + page_size) is returned and billed.

cursorstring

Bookmark returned as next_cursor by the previous page. Pass it when walking pages sequentially, since it is the cheapest and most stable way to page. Without it, page/offset addressing still works.

Response

Default Response

Changes

No recorded changes to this operation across all 2 revisions of this API.