People Search

Search for people in bulk

Pull a whole audience across many pages in one call. Returns a task id straight away; results arrive later.

Set start_page, and end_page to stop at a given page; omit it to pull everything that matches.

• The merged results are POSTed to your webhook_url on completion. • Or poll GET /people/search/bulk?job_id=<task_id> whenever you like.

1 credit per profile found. Send an Idempotency-Key header to make retries safe for 24h.

post/api/v1/people/search/bulk

Request

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

Headers

idempotency-keystring

Optional per-submission key so client retries don't create duplicate tasks. Replay window: 24h.

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.

customobject

Arbitrary metadata echoed back verbatim in the webhook payload and poll response

Response

Default Response

taskIdstring
status'queued'
startPageinteger
endPageinteger nullable

Changes

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