---
title: "List people"
description: "The people behind your mentions: one row per person, with their accounts, reach, public profile, per-workspace stats, your annotations and where your outreach stands. Filter by platform, tag, follower range, mention counts, intents seen, keyword kinds mentioned or never mentioned, outreach stage, owner, automated (bot accounts, whose matched posts are mostly machine-made), or a saved segment. Offset-paginated with a total."
canonical: https://docs.mentio.dev/api/people/list-people
markdown: https://docs.mentio.dev/api/people/list-people.mdx
---

# List people

`GET /v1/people`

The people behind your mentions: one row per person, with their accounts, reach, public profile, per-workspace stats, your annotations and where your outreach stands. Filter by platform, tag, follower range, mention counts, intents seen, keyword kinds mentioned or never mentioned, outreach stage, owner, automated (bot accounts, whose matched posts are mostly machine-made), or a saved segment. Offset-paginated with a total.

## Parameters

- `platform` (query): People with an account on this platform.
- `q` (query): Matches the display name or the profile handle or URL, case-insensitively.
- `tag` (query): Only people carrying this tag (exact, case-sensitive).
- `muted` (query): true: only muted people; false: only unmuted; omitted: everyone.
- `since` (query): Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms).
- `segmentId` (query): A saved segment applied on top of every other filter here. Unknown id: 404.
- `platforms` (query): People with an account on any of these platforms. Repeatable, or comma-separated.
- `tags` (query): People carrying any of these tags. Repeatable, or comma-separated.
- `minFollowers` (query): At least this many followers. Unknown reach never matches.
- `maxFollowers` (query): At most this many followers.
- `minMentions` (query): At least this many matched mentions.
- `minNegative` (query): At least this many negative mentions.
- `intents` (query): At least one mention carrying any of these intents.
- `notPlatforms` (query): Nobody with an account on these platforms. Repeatable, or comma-separated.
- `notTags` (query): Nobody carrying any of these tags. Repeatable, or comma-separated.
- `notIntents` (query): Nobody whose mentions carry any of these intents. Repeatable, or comma-separated.
- `keywordKinds` (query): Mentioned a keyword of any of these kinds.
- `neverKeywordKinds` (query): Never mentioned a keyword of these kinds.
- `newSinceDays` (query): First seen within this many days.
- `linkHosts` (query): People with at least one mention linking to any of these hosts, the host itself or a subdomain of it. Repeatable, or comma-separated.
- `stages` (query): People at any of these outreach stages. Repeatable, or comma-separated.
- `automated` (query): true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest; omitted: everyone.
- `ownerIds` (query): People owned by any of these members (user ids); `none` matches people nobody owns. Repeatable, or comma-separated.
- `sort` (query): mentions: most matches first. recent: last seen first. reach: most followers first, unknown last. new: first seen most recently first.
- `limit` (query): Page size, 1 to 100.
- `offset` (query): Skip this many people. Offset paging: a grouped read over hundreds of people, not a stream.

## Responses

- 200: One page of people
- 400: Invalid query
- 401: Missing or invalid API key
- 404: No such segment for your workspace

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx