People

List 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. With groupId, only the people who mentioned that keyword group's keywords, counted over those mentions, with that group's own annotations, merges, outreach and segments.

get/v1/people

Request

  • Base URL: https://api.mentio.dev
  • URL: https://api.mentio.dev/v1/people
  • Auth: HTTP bearer

Query parameters

groupIdstring

Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

platform'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'

People with an account on this platform.

qstring

Matches the display name or the profile handle or URL, case-insensitively.

handlestring

Find a person by one of their accounts: a handle (@jane, u/jane, jane) or a profile or post link (https://x.com/jane). Exact, case-insensitive, merged accounts included; combine with platform to pick one platform. A link names its own platform.

tagstring

Only people carrying this tag (exact, case-sensitive).

mutedboolean

true: only muted people; false: only unmuted; omitted: everyone.

sincestring date-time

Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms).

segmentIdstring

A saved segment applied on top of every other filter here. Unknown id: 404.

platformsstring[]

People with an account on any of these platforms. Repeatable, or comma-separated.

tagsstring[] nullable

People carrying any of these tags. Repeatable, or comma-separated.

minFollowersinteger nullable

At least this many followers. Unknown reach never matches.

maxFollowersinteger nullable

At most this many followers.

minMentionsinteger

At least this many matched mentions.

minNegativeinteger

At least this many negative mentions.

intentsstring[] nullable

At least one mention carrying any of these intents.

notPlatformsstring[]

Nobody with an account on these platforms. Repeatable, or comma-separated.

notTagsstring[] nullable

Nobody carrying any of these tags. Repeatable, or comma-separated.

notIntentsstring[] nullable

Nobody whose mentions carry any of these intents. Repeatable, or comma-separated.

keywordKindsstring[]

Mentioned a keyword of any of these kinds.

neverKeywordKindsstring[]

Never mentioned a keyword of these kinds.

newSinceDaysinteger

First seen within this many days.

linkHostsstring[] nullable

People with at least one mention linking to any of these hosts, the host itself or a subdomain of it. Repeatable, or comma-separated.

stagesstring[]

People at any of these outreach stages. Repeatable, or comma-separated.

automatedboolean

true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest; omitted: everyone.

ownerIdsstring[] nullable

People owned by any of these members (user ids); none matches people nobody owns. Repeatable, or comma-separated.

sort'mentions' | 'recent' | 'reach' | 'new'

mentions: most matches first. recent: last seen first. reach: most followers first, unknown last. new: first seen most recently first.

limitinteger

Page size, 1 to 100.

offsetinteger nullable

Skip this many people. Offset paging: a grouped read over hundreds of people, not a stream.

Response

One page of people

totalinteger required

People matching the filters, across all pages.

Changes

No recorded changes to this operation across all 1 revision of this API.