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. At most 6 exports per minute per workspace; a 429 carries Retry-After.

Authorization

AuthorizationBearer <token>

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

In: header

Query Parameters

platform?string

People with an account on this platform.

q?string

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

Length1 <= length <= 200

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

curl -X GET "https://api.mentio.dev/v1/people/export.csv"

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
  }
}

Export people as CSV

Authorization

Query Parameters

Response Body

200text/csv

400application/json

401application/json

404application/json

429application/json

text/csv

application/json

application/json

application/json

application/json