| q | No | Free-text query. Each term is matched (substring, accent-insensitive) against name, headline, current company, location, skills, GitHub repo languages/topics, bio, every linked account's names/usernames/headlines/bios and past roles (company + title). Your own people also match your recorded interactions, memories, notes and tags; a teammate's people (scope:'team') match only their public profile text, never the teammate's private history, notes or tags. Name hits rank highest; bio, past-role, note and tag hits rank lowest. Terms are OR-matched; operators narrow: uppercase AND between terms requires all of them; a +term prefix requires just that term (e.g. '+health medtech'). Optional in scope:'own'/'team' (omit to browse with filters). In scope:'public', operators only affect the your-network half of results; global hits are matched by semantic similarity. | |
| role | No | Filter by function (matched against the headline and, in your own network, past titles): engineer, designer, product, gtm, founder, recruiter, investor, other. `gtm` covers sales/growth/marketing/partnerships/biz-dev; `other` is the catch-all for customer success, operations, legal, academia, etc. Matches any of the listed roles. Seniority (CEO, CTO, VP, etc.) is not a function — pass it in `q` instead. | |
| tags | No | Require all of these tags you've applied. | |
| limit | No | Page size (own/team: default 25, max 200; public: default 40, max 50). | |
| scope | No | 'own' (default) — your network only. 'public' — global match + warm-intro paths to people you don't know yet. 'team' — your POOLED TEAM network (people known by ANY teammate), with the same filters and exact `total` as 'own' (no cap; page with offset/limit). Each team hit carries `team_members` (who on the team knows them, their consent-gated strength and teams), `team_ids`, and `primary_team_id` — pass that as get_person's team_id. | |
| stale | No | Only people you've never interacted with, or not in 90+ days. | |
| offset | No | Pagination offset. | |
| recent | No | Only people you've interacted with in the last 14 days. | |
| skills | No | Require all of these skills. | |
| company | No | Filter by company — substring match on current OR former employers (each hit's `company_match` says which). In scope:'public' only the current company is checked. | |
| sources | No | Restrict to people who came from any of these sources. | |
| team_id | No | For scope:'team' — the team_id of one team to search (from account_status.teams). Omit it to search every team you're in (a person several teams share is one hit, with all their `team_ids`). A team you don't belong to is rejected. | |
| location | No | Filter by location (substring match; common aliases such as NYC/New York, SF/Bay Area, Lisbon/Lisboa expand). | |
| added_after | No | Only people added to your network ON/AFTER this date (ISO, e.g. 2026-06-01). For "who did I add this week / since X?". Adding ≠ interacting — for interaction recency use recent/stale. | |
| added_before | No | Only people added STRICTLY BEFORE this date (ISO). | |
| last_interaction_after | No | Only people whose last recorded touchpoint was ON/AFTER this date (ISO, e.g. 2026-06-22 or 2026-06-22T00:00:00Z). Use for 'who did I interact with on/since <date>' or 'everyone with a touchpoint this week'. People with no interaction are excluded. Combine with last_interaction_before for a date range. | |
| last_interaction_before | No | Only people whose last recorded touchpoint was STRICTLY BEFORE this date (ISO, exclusive upper bound). People with no interaction are excluded. Combine with last_interaction_after for a date range. | |