---
title: "Export mentions as JSON"
description: "The same mentions GET /v1/mentions would list for these filters, in one response, newest matched first (the order they entered your feed): every row is the full Mention object the list returns, text included. Capped at 10,000 mentions; `truncated` (and the X-Mentions-Truncated header) says when the cap cut the list. Shares the CSV export's limit: at most 6 exports per minute per workspace, either format; a 429 carries Retry-After."
canonical: https://docs.mentio.dev/api/mentions/export-mentions-json
markdown: https://docs.mentio.dev/api/mentions/export-mentions-json.mdx
---

# Export mentions as JSON

`GET /v1/mentions/export.json`

The same mentions GET /v1/mentions would list for these filters, in one response, newest matched first (the order they entered your feed): every row is the full Mention object the list returns, text included. Capped at 10,000 mentions; `truncated` (and the X-Mentions-Truncated header) says when the cap cut the list. Shares the CSV export's limit: at most 6 exports per minute per workspace, either format; 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 or topic tag (buy_intent, question, complaint, praise, comparison, churn_intent, bug_report, pricing, hiring, event, promotional, testimonial, industry_insight, launch, feedback).
- `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.
- `minConfidence` (query): Only mentions whose classifier confidence is at least this, 0 to 1. Mentions without a confidence 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.
- `viewId` (query): Apply a saved view's filter (an id from GET /v1/views) on top of the other filters, every condition ANDed: exactly what the view selects. Unknown ids are a 404.
- `keywordKinds` (query): Only matches of keywords of any of these kinds: brand, competitor, topic. Repeatable, or comma-separated.
- `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.
- `groupIds` (query): Only matches of keywords in any of these groups (grp_...). Repeatable, or comma-separated.
- `notGroupIds` (query): Never matches of keywords in these groups.
- `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 intent or topic tags.
- `notIntents` (query): Never mentions carrying these intent or topic tags.
- `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.
- `ratings` (query): Only app store reviews with any of these star ratings (1 to 5): ratings=1,2 is the unhappy ones. Every other post fails it.
- `notRatings` (query): Never reviews with these star ratings (1 to 5): notRatings=5 hides the five star reviews. Posts that are not reviews still pass.
- `minLikes` (query): Only posts with at least this many likes (upvotes, reactions), as the platform reported them when the post was found. A post without that count never passes.
- `minReposts` (query): Only posts with at least this many reposts (shares, retweets), as the platform reported them when the post was found. A post without that count never passes.
- `minReplies` (query): Only posts with at least this many replies (comments), as the platform reported them when the post was found. A post without that count never passes.
- `minQuotes` (query): Only posts with at least this many quotes, as the platform reported them when the post was found. A post without that count never passes.
- `minViews` (query): Only posts with at least this many views (plays), as the platform reported them when the post was found. A post without that count never passes.
- `minBookmarks` (query): Only posts with at least this many bookmarks (saves), as the platform reported them when the post was found. A post without that count never passes.
- `anyOf` (query): OR across groups of conditions, as URL-encoded JSON: [{"platforms":["reddit"],"sentiments":["negative"]},{"intents":["buy_intent"]}] is "negative on Reddit, or buying intent anywhere". Each group holds the conditions of a view filter (lists any-of, not lists none-of, all ANDed); a mention passes when at least one group holds, and every other filter here still applies. 1 to 10 groups, none empty, no nesting.
- `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: Every matching mention, up to the cap
- 400: Invalid query, or filter_too_complex: the filters together name more values than one query can carry
- 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