Export mentions as 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.
Request
- Base URL: https://api.mentio.dev
- URL: https://api.mentio.dev/v1/mentions/export.json
- Auth: HTTP bearer
Query parameters
Only matches of this keyword.
Only posts from this platform.
Only mentions in this status. Omit for every status.
true: only mentions the classifier scored relevant; false: only the rest (unclassified included).
Only this sentiment.
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).
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.
true: only posts by companies, brands and organizations (a LinkedIn company page, a GitHub organization, a business account); false: only posts by people, mentions judged before this existed included. Omitted: everything.
Only this person (an id from /v1/people), merged accounts included. Implies includeMuted.
true: include mentions by people you muted, hidden by default: muted for the workspace, or for the mention's own keyword group.
true: list cross-posts (a mention whose duplicateOf is set) as mentions of their own. By default each is listed only in its original's duplicates.
Only mentions assigned to this workspace member (user id).
true: only mentions currently snoozed. Otherwise snoozed mentions stay out until they wake.
Hide these authors: display names, handles or profile URLs. Repeatable, or one comma-separated value.
Only mentions scored at least this; unclassified ones are excluded.
Only mentions whose classifier confidence is at least this, 0 to 1. Mentions without a confidence are excluded.
Only authors with at least this many followers. Unknown reach never passes.
Only authors with at most this many followers. Unknown reach never passes.
Only posts (post), only comments (comment) or only GitHub repository events (repository). Omitted: all.
true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
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.
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.
Only matches of keywords of any of these kinds: brand, competitor, topic. Repeatable, or comma-separated.
Only authors tagged with any of these (exact, case-sensitive), in the workspace's tags or those of the mention's own keyword group. Repeatable, or comma-separated.
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.
Only posts from any of these platforms.
Never posts from these platforms.
Only matches of any of these keywords.
Only matches of keywords in any of these groups (grp_...). Repeatable, or comma-separated.
Never matches of keywords in these groups.
Never matches of these keywords.
Only these sentiments.
Never these sentiments. A mention the classifier has not scored yet still passes.
Only mentions carrying any of these intent or topic tags.
Never mentions carrying these intent or topic tags.
Never posts linking to these hosts, the host itself or a subdomain of it.
Only Reddit posts from any of these subreddits: subreddits=SaaS,startups (names without the r/, any case). Every other post fails it. Repeatable, or comma-separated.
Never Reddit posts from these subreddits; posts from other platforms still pass.
Never authors tagged with any of these, in the workspace's tags or those of the mention's own keyword group.
Only posts in any of these languages (ISO 639-1: en, es, de). A post whose language is unknown never passes.
Never posts in these languages. A post whose language is unknown still passes.
Only posts whose author is in any of these countries (ISO 3166-1 alpha-2: us, in, de), as the classifier read the author's profile and the post. A post whose country is unknown never passes.
Never posts whose author is in these countries: notCountries=in. A post whose country is unknown still passes.
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.
Never reviews with these star ratings (1 to 5): notRatings=5 hides the five star reviews. Posts that are not reviews still pass.
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.
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.
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.
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.
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.
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.
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.
Substring search in the post text or the author's name.
Only posts published at or after this instant (ISO 8601, or epoch ms).
Only posts published at or before this instant (ISO 8601, or epoch ms).
Response
Every matching mention, up to the cap
Changes
No recorded changes to this operation across all 1 revision of this API.