---
title: "Export mentions as CSV"
description: "The same mentions GET /v1/mentions would list for these filters, as CSV, newest matched first (the order they entered your feed, which can differ from the post date): id, published_at, platform, keyword, author, author_url, author_followers, relevance, sentiment, intents (pipe-separated), status, relevant, delivered, url, text (first 1,000 characters). Capped at 10,000 rows; the X-Mentions-Truncated header says when the cap cut the list. At most 6 exports per minute per workspace; a 429 carries Retry-After."
canonical: https://docs.mentio.dev/api/mentions/export-mentions-csv
markdown: https://docs.mentio.dev/api/mentions/export-mentions-csv.mdx
---

# Export mentions as CSV

`GET /v1/mentions/export.csv`

The same mentions GET /v1/mentions would list for these filters, as CSV, newest matched first (the order they entered your feed, which can differ from the post date): id, published_at, platform, keyword, author, author_url, author_followers, relevance, sentiment, intents (pipe-separated), status, relevant, delivered, url, text (first 1,000 characters). Capped at 10,000 rows; the X-Mentions-Truncated header says when the cap cut the list. At most 6 exports per minute per workspace; a 429 carries Retry-After.

## Parameters

- `keywordId` (query): Only matches of this keyword.
- `platform` (query): Only posts from this platform.
- `status` (query): Only mentions in this status. Omit for every status.
- `relevant` (query): true: only mentions the classifier scored relevant; false: only the rest (unclassified included).
- `sentiment` (query): Only this sentiment.
- `intent` (query): Only mentions carrying this intent (buy_intent, question, complaint, praise, comparison).
- `automated` (query): true: only mentions that read as machine-made (a bot account, a scheduled or templated post, AI-written text); false: only the rest, mentions judged before this existed included. Omitted: everything.
- `personId` (query): Only this person (an id from /v1/people), merged accounts included. Implies includeMuted.
- `includeMuted` (query): true: include mentions by people you muted, hidden by default.
- `assigneeId` (query): Only mentions assigned to this workspace member (user id).
- `snoozed` (query): true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake.
- `excludeAuthors` (query): Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value.
- `minRelevance` (query): Only mentions scored at least this; unclassified ones are excluded.
- `minFollowers` (query): Only authors with at least this many followers. Unknown reach never passes.
- `maxFollowers` (query): Only authors with at most this many followers. Unknown reach never passes.
- `isReply` (query): true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
- `alertId` (query): Apply an alert rule's filter (an id from GET /v1/alerts) on top of the other filters: the same mentions the rule would send, for a feed-shaped export or a preview. Unknown ids are a 404.
- `tags` (query): Only authors your workspace tagged with any of these (exact, case-sensitive). Repeatable, or comma-separated.
- `linkHosts` (query): Only posts linking to any of these hosts, the host itself or a subdomain of it (octolens.com also matches blog.octolens.com). Repeatable, or comma-separated.
- `platforms` (query): Only posts from any of these platforms.
- `notPlatforms` (query): Never posts from these platforms.
- `keywordIds` (query): Only matches of any of these keywords.
- `notKeywordIds` (query): Never matches of these keywords.
- `sentiments` (query): Only these sentiments.
- `notSentiments` (query): Never these sentiments. A mention the classifier has not scored yet still passes.
- `intents` (query): Only mentions carrying any of these intents.
- `notIntents` (query): Never mentions carrying these intents.
- `notLinkHosts` (query): Never posts linking to these hosts, the host itself or a subdomain of it.
- `notTags` (query): Never authors your workspace tagged with any of these.
- `languages` (query): Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes.
- `notLanguages` (query): Never posts in these languages. A post whose language is unknown still passes.
- `q` (query): Substring search in the post text or the author's name.
- `since` (query): Only posts published at or after this instant (ISO 8601, or epoch ms).
- `until` (query): Only posts published at or before this instant (ISO 8601, or epoch ms).

## Responses

- 200: CSV, UTF-8
- 400: Invalid query
- 401: Missing or invalid API key
- 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