PloidDocs
Search

Search

Run fast people search with optional hard filters for title, company, and location.

Search people

ploid search "AI security founders in San Francisco" \
  --limit 25 \
  --type auto
ploid search "revenue leaders" \
  --title "VP Sales" \
  --company "Datadog" \
  --location "New York"
OptionValues
--title <title>Hard filter: current job title must hold this role
--company <company>Hard filter: current employer name
--location <location>Hard filter: city, state, or country
--limit <n>1–150; default 25
--type <type>instant, fast, auto, or deep; default auto

These flags are the title, company, and location hard filters on POST /v1/search. A person who contradicts one is not returned. See Search for how each filter matches, including role-intent titles and named-person company handling.

Put --json before the command for machine-readable output.

ploid --json search "revenue leaders at developer-tool startups"

Errors and limits

Search is limited to 150 results per call and to 30 calls per minute and 300 per hour, plus the organization/API-key bucket. A timeout or temporary search failure exits with status 2; retry it with bounded backoff. People Sets (preview) are available through the API, not the CLI. See CLI errors & rate limits.