List people
list_peopleRead-onlyIdempotent
Lists the authors of mentions of your keywords. Each has name, profile, platform, how many posts matched and how many scored relevant, sentiment split, first and last seen, and outreach status (owner, stage, last contacted). You can filter by platform or name, find one person by handle or profile link (handle), and filter by outreach stage (stages), owner (ownerIds, or "none" for no owner) or automated (bots whose posts are mostly machine-made). Sort by mentions or by recency. To read what one person said, use search_mentions with personId.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_people"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Searches the display name, handle and profile link | |
| tag | No | Keeps people with this tag | |
| sort | No | "mentions" puts the most matches first, "recent" the most recently seen, "reach" the most followers, and "new" people seen for the first time most recently | mentions |
| tags | No | Keeps people with one of these tags | |
| limit | No | ||
| muted | No | true keeps muted people and false people who are not muted. Leave it out for everyone | |
| since | No | Keeps people whose first matched mention is at this time or later, as ISO 8601 or epoch ms. Use it to find new voices | |
| handle | No | Looks up one person by an account, given as a handle (@sam, u/sam) or a profile or post link (https://x.com/sam). The match is exact but ignores case. Add platform to pick one platform | |
| offset | No | How many people to skip, for paging | |
| stages | No | Only people in one of these outreach stages | |
| intents | No | Has a mention tagged with one of these intents | |
| ownerIds | No | Keeps people owned by one of these members, by user id. Use "none" for people without an owner | |
| platform | No | Only people with a profile on this platform | |
| automated | No | true keeps people whose matched posts are mostly machine-made, such as bots. false keeps the others | |
| linkHosts | No | Keeps people with a mention that links to one of these hosts or its subdomains, so slack.com also matches api.slack.com | |
| platforms | No | Keeps people with an account on one of these platforms | |
| segmentId | No | Adds a saved segment's filter (from list_segments) to the other filters | |
| minMentions | No | Minimum number of matched mentions | |
| minNegative | No | Minimum number of negative mentions | |
| keywordKinds | No | Keeps people who mentioned a keyword of one of these kinds (brand, competitor, topic) | |
| maxFollowers | No | ||
| minFollowers | No | Keeps people with this many followers or more. Unknown counts are left out | |
| newSinceDays | No | Keeps people first seen in the past this many days | |
| neverKeywordKinds | No | Excludes people who mentioned these keyword kinds |