---
title: "Export people as CSV"
description: "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."
canonical: https://docs.mentio.dev/api/people/export-people-csv
markdown: https://docs.mentio.dev/api/people/export-people-csv.mdx
---

# Export people as CSV

`GET /v1/people/export.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.

## Parameters

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

## Responses

- 200: CSV, UTF-8
- 400: Invalid query
- 401: Missing or invalid API key
- 404: No such segment for your workspace
- 429: More than 6 exports this minute; retry after the Retry-After seconds

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx