OverviewPlatformsAPI Reference
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

Authorization

AuthorizationBearer <token>

API key minted via POST /v1/api-keys (format mk_live_...)

In: header

Query Parameters

groupId?string

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.

Length1 <= length
platform?string

People with an account on this platform.

Value in"bluesky" | "hackernews" | "github" | "stackoverflow" | "devto" | "reddit" | "x" | "youtube" | "news" | "linkedin" | "tiktok" | "instagram" | "appstore" | "googleplay" | "trustpilot" | "googlemaps" | "rss"
q?string

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

Length1 <= length <= 200
handle?string

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.

Length1 <= length <= 300
tag?string

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

Length1 <= length <= 40
muted?boolean

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

since?string

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

Formatdate-time
segmentId?string

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

Length1 <= length
platforms?array<string>

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

Itemsitems <= 20
tags?|null

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

Itemsitems <= 20
minFollowers?integer|null

At least this many followers. Unknown reach never matches.

Range0 <= value
maxFollowers?integer|null

At most this many followers.

Range0 <= value
minMentions?integer

At least this many matched mentions.

Range1 <= value
minNegative?integer

At least this many negative mentions.

Range1 <= value
intents?|null

At least one mention carrying any of these intents.

Itemsitems <= 10
notPlatforms?array<string>

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

Itemsitems <= 20
notTags?|null

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

Itemsitems <= 20
notIntents?|null

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

Itemsitems <= 10
keywordKinds?array<string>

Mentioned a keyword of any of these kinds.

Itemsitems <= 3
neverKeywordKinds?array<string>

Never mentioned a keyword of these kinds.

Itemsitems <= 3
newSinceDays?integer

First seen within this many days.

Range1 <= value <= 365
linkHosts?|null

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

Itemsitems <= 20
stages?array<string>

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

Itemsitems <= 6
automated?boolean

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

ownerIds?|null

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

Itemsitems <= 20
sort?string

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

Default"mentions"
Value in"mentions" | "recent" | "reach" | "new"

Response Body

text/csv

application/json

application/json

application/json

application/json

curl -X GET "https://api.mentio.dev/v1/people/export.csv"
"string"
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}
{
  "error": {
    "code": "unauthorized",
    "message": "string",
    "requestId": "string",
    "retryAfterSeconds": 0
  }
}

Delete an outreach activity DELETE

Remove a contact logged by mistake. The person's owner and stage stay as they are. With `groupId`, the call works inside that keyword group: its people, and its own tags, notes, mute, merges and activities, apart from the workspace's and from every other group's.

Get a person GET

One person as your workspace sees them. An account merged into someone resolves to that person. With `groupId`, the call works inside that keyword group: its people, and its own tags, notes, mute, merges and activities, apart from the workspace's and from every other group's.