---
title: "Export people as CSV"
method: GET
path: "/v1/people/export.csv"
tags: ["People"]
---

# Export people as CSV

`GET /v1/people/export.csv`

## Request

- Base URL: `https://api.mentio.dev`
- URL: `https://api.mentio.dev/v1/people/export.csv`
- Auth: HTTP bearer

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.

## 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.
- `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.
- `q` string: Matches the display name or the profile handle or URL, case-insensitively.
- `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.
- `tag` string: Only people carrying this tag (exact, case-sensitive).
- `muted` boolean: true: only muted people; false: only unmuted; omitted: everyone.
- `since` string, date-time: Only people whose first matched mention is at or after this instant (ISO 8601, or epoch ms).
- `segmentId` string: A saved segment applied on top of every other filter here. Unknown id: 404.
- `platforms` string[]: People with an account on any of these platforms. Repeatable, or comma-separated.
- `tags` string[], nullable: People carrying any of these tags. Repeatable, or comma-separated.
- `minFollowers` integer, nullable: At least this many followers. Unknown reach never matches.
- `maxFollowers` integer, nullable: At most this many followers.
- `minMentions` integer: At least this many matched mentions.
- `minNegative` integer: At least this many negative mentions.
- `intents` string[], nullable: At least one mention carrying any of these intents.
- `notPlatforms` string[]: Nobody with an account on these platforms. Repeatable, or comma-separated.
- `notTags` string[], nullable: Nobody carrying any of these tags. Repeatable, or comma-separated.
- `notIntents` string[], nullable: Nobody whose mentions carry any of these intents. Repeatable, or comma-separated.
- `keywordKinds` string[]: Mentioned a keyword of any of these kinds.
- `neverKeywordKinds` string[]: Never mentioned a keyword of these kinds.
- `newSinceDays` integer: First seen within this many days.
- `linkHosts` string[], 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.
- `stages` string[]: People at any of these outreach stages. Repeatable, or comma-separated.
- `automated` boolean: true: only people whose matched posts are mostly machine-made (bot accounts); false: only the rest; omitted: everyone.
- `ownerIds` string[], 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 `200`

CSV, UTF-8

## Other responses

- `400`: Invalid query
- `401`: Missing or invalid API key
- `404`: No such segment in this scope, or no such group
- `429`: More than 6 exports this minute; retry after the Retry-After seconds

---

[API](https://skmtc.dev/mentio/apis/mentio-api.md) · [All operations](https://skmtc.dev/mentio/apis/mentio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mentio/apis/mentio-api/revisions/b16a21d0ed02?raw)