CompanyEnrich인물 데이터Enrichment

Search people by title, seniority, department or company

companyenrich.people.search

Searches people based on given criteria using page-based pagination

가격: $0.0196/result정가 기준
성공률: 100%최근 30일 · 61,421회
지연 시간 p50: 298 msp95 21 s
마지막 검증: 2026. 8. 20.동작 확인됨

POSThttps://toolswitch.dev/v1/tools/companyenrich.people.searchBeta

플랫폼 할당량 사용
동기 응답
공개 데이터 읽기

파라미터

BILLS PER RESULT — 2 credits per person, with a 2-credit minimum when nothing matches. There is no free count route for people (unlike companies), so keep pageSize at 1 while you tune filters. Results carry name, location, socials.linkedin_url and the full `experiences` array with position, seniority and department per role — but NOT an email address; that is a separate, dearer call (companyenrich.people.email).

파라미터	유형	필수	설명	예시
쿼리 파라미터
`expand`	array[string]	선택	`education` adds the education block at extra credit cost per person
요청 본문(JSON)
`page`	정수	선택	1-based; page * pageSize may not exceed 10,000 — past that use the scroll route	`1`
`query`	문자열	선택	free-text match on the employer's name and domain, max 250 chars
`domains`	array[string]	선택	employer domains, up to 2,500 — the usual way to enumerate a company's staff	`["stripe.com"]`
`exclude`	객체	선택	people or companies to drop from the results
`pageSize`	정수	선택	1-100, default 10. THIS IS THE PRICE — 2 credits per PERSON returned, so a default page costs 20 credits	`1`
`countries`	array[string]	선택	ISO 3166-1 alpha-2 codes
`education`	객체	선택	school/degree filter
`seniority`	array[string]	선택	one or more of owner, founder, c-suite, partner, vp, head, director, manager, senior, entry, intern. NOTE the hyphen in `c-suite` — an underscore is rejected with a bodyless HTTP 400	`["c-suite"]`
`department`	array[string]	선택	hierarchical department slugs, e.g. c-suite/finance-executive, engineering-technical/data-science
`companyFilter`	객체	선택	a nested company lookup — search people at companies matching firmographic criteria rather than a fixed domain list
`positionQuery`	array[string]	선택	free-text matches on the person's CURRENT job title; resolve real titles first with the free /positions/autocomplete	`["Chief Executive Officer"]`
`atCurrentCompanyAfter`	문자열	선택	UTC date — only people who joined their current employer after it; the job-change signal
`atCurrentCompanyBefore`	문자열	선택	UTC date — only people who joined before it
`atCurrentPositionAfter`	문자열	선택	UTC date — only people promoted into their current role after it
`atCurrentPositionBefore`	문자열	선택	UTC date

쿼리 파라미터
expandarray[string]선택
`education` adds the education block at extra credit cost per person
요청 본문(JSON)
page정수선택
1-based; page * pageSize may not exceed 10,000 — past that use the scroll route
예시: 1
query문자열선택
free-text match on the employer's name and domain, max 250 chars
domainsarray[string]선택
employer domains, up to 2,500 — the usual way to enumerate a company's staff
예시: ["stripe.com"]
exclude객체선택
people or companies to drop from the results
pageSize정수선택
1-100, default 10. THIS IS THE PRICE — 2 credits per PERSON returned, so a default page costs 20 credits
예시: 1
countriesarray[string]선택
ISO 3166-1 alpha-2 codes
education객체선택
school/degree filter
seniorityarray[string]선택
one or more of owner, founder, c-suite, partner, vp, head, director, manager, senior, entry, intern. NOTE the hyphen in `c-suite` — an underscore is rejected with a bodyless HTTP 400
예시: ["c-suite"]
departmentarray[string]선택
hierarchical department slugs, e.g. c-suite/finance-executive, engineering-technical/data-science
companyFilter객체선택
a nested company lookup — search people at companies matching firmographic criteria rather than a fixed domain list
positionQueryarray[string]선택
free-text matches on the person's CURRENT job title; resolve real titles first with the free /positions/autocomplete
예시: ["Chief Executive Officer"]
atCurrentCompanyAfter문자열선택
UTC date — only people who joined their current employer after it; the job-change signal
atCurrentCompanyBefore문자열선택
UTC date — only people who joined before it
atCurrentPositionAfter문자열선택
UTC date — only people promoted into their current role after it
atCurrentPositionBefore문자열선택
UTC date

코드 예제

$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.

Beta

curl -X POST 'https://toolswitch.dev/v1/tools/companyenrich.people.search' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{"page":1,"domains":["stripe.com"],"pageSize":1,"seniority":["c-suite"]}'

import os
import json
import requests

response = requests.request(
    "POST",
    "https://toolswitch.dev/v1/tools/companyenrich.people.search",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
    json=json.loads("{\"page\":1,\"domains\":[\"stripe.com\"],\"pageSize\":1,\"seniority\":[\"c-suite\"]}"),
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/companyenrich.people.search", {
  method: "POST",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(JSON.parse("{\"page\":1,\"domains\":[\"stripe.com\"],\"pageSize\":1,\"seniority\":[\"c-suite\"]}")),
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

게이트웨이 API는 Beta이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 $0.0196/result이며 서비스 수수료가 포함되어 있습니다.