People

Export people as CSV

The same list as GET /v1/people (segmentId included) as CSV, one row per person with their contact columns: handle, followers, email, website, company, location, tags, then outreach stage, owner and last contacted. Capped at 5,000 people. groupId scopes the export like the list. At most 6 exports per minute per workspace; a 429 carries Retry-After.

get/v1/people/export.csv

Request

  • Base URL: https://api.mentio.dev
  • URL: https://api.mentio.dev/v1/people/export.csv
  • 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.

Response

CSV, UTF-8

Changes

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