Mentio Python SDK
Social listening for developers, in Python. Mentio watches Reddit, Hacker News, X, GitHub, Bluesky, LinkedIn, Stack Overflow, DEV, YouTube and news for your keywords and scores every mention for relevance, sentiment and intent. This package is the official Python client for its API: one object, one call per endpoint, generated from the OpenAPI document and regenerated whenever the API changes, so it is always complete. Python 3.11+, sync and async, typed.
Installation
pip install mentio
Quick start
from mentio import Mentio
mentio = Mentio(api_key="mk_live_...")
# Track a keyword on two platforms.
keyword = mentio.keywords.create(term="acme cloud", kind="brand", platforms=["reddit", "x"])
# Read what arrived, relevant posts only, newest first.
for mention in mentio.mentions.search(platform="reddit", relevant=True, limit=25).data:
print(mention.post.platform.value, mention.classification.relevance, mention.post.url)
An API key comes from the dashboard (Settings, API keys) or from mentio.api_keys.create(...) with an existing key. Every account starts with $5.80 of credit and no card.
Configuration
mentio = Mentio(
api_key="mk_live_...", # required
base_url="https://api.mentio.dev", # another deployment's host, if you run one
timeout=30.0, # seconds, or None for no timeout
)
Enum-valued arguments take plain strings (platform="reddit"). Instants take a datetime, an ISO 8601 string, or epoch milliseconds. Bodies take a dict, a model, or their fields as keyword arguments.
Examples
Page through every mention of the last week
from datetime import datetime, timedelta, timezone
since = datetime.now(timezone.utc) - timedelta(days=7)
cursor = None
while True:
page = mentio.mentions.search(since=since, relevant=True, limit=100, cursor=cursor)
for mention in page.data:
print(mention.post.url)
cursor = page.next_cursor
if not cursor:
break
Filter by intent and sentiment
hot = mentio.mentions.search(intent="buy_intent", sentiment="negative", min_followers=1000, sort="priority")
Intents are buy_intent, question, complaint, praise and comparison. sort="priority" puts fresh, relevant, high-reach posts first.
Triage
mentio.mentions.update("mm_7f3a...", status="done", note="replied 2026-09-14")
mentio.mentions.update("mm_9c1b...", status="ignored")
An instant Slack alert for buying signals on Reddit
slack = next(c for c in mentio.channels.list().data if c.kind == "slack")
mentio.alerts.create(
name="Reddit buying signals",
mode="instant",
filter={"platforms": ["reddit"], "intents": ["buy_intent"], "minRelevance": 40},
channelIds=[slack.id],
)
Body fields keep the API's names (channelIds, minRelevance); query parameters are snake_case (min_followers). Slack, Telegram, email and webhook channels are created with mentio.channels.create(...); mentio.alerts.test(id) sends a sample; mentio.alerts.run(id) sends a daily alert's last 24 hours now.
Analytics
summary = mentio.analytics.summary(range_="30d", compare=True, timezone="Europe/Madrid")
by_platform = mentio.analytics.breakdown(range_="30d", by="platform")
sov = mentio.analytics.share_of_voice(range_="90d")
People
people = mentio.people.list(platforms=["x"], min_followers=5000)
mentio.people.update(people.data[0].id, tags=["influencer"], muted=False)
CSV export
csv_text = mentio.mentions.export(since="2026-09-01T00:00:00Z")
Async
AsyncMentio mirrors every call for asyncio:
import asyncio
from mentio import AsyncMentio
async def main() -> None:
mentio = AsyncMentio(api_key="mk_live_...")
page = await mentio.mentions.search(relevant=True, limit=10)
for mention in page.data:
print(mention.post.url)
asyncio.run(main())
Error handling
A non-2xx raises MentioError with the API's status, code and message:
from mentio import Mentio, MentioError
try:
mentio.keywords.create(term="acme", kind="brand")
except MentioError as err:
if err.code == "duplicate_keyword":
pass # already tracked
elif err.code == "insufficient_balance":
print("top up from Billing")
elif err.code == "rate_limited":
print("slow down")
else:
raise
The full catalog, with status and meaning, is at docs.mentio.dev/errors. Common codes: unauthorized, forbidden, read_only_key, validation_error, not_found, invalid_cursor, rate_limited, duplicate_keyword, insufficient_balance, keyword_limit_reached, upstream_unavailable, internal_error.
SDK reference
| Resource | Methods |
|---|---|
mentio.keywords |
create, list, get, update, delete |
mentio.mentions |
search, get, update, export |
mentio.people |
list, get, update, merge, split, export |
mentio.segments |
list, create, get, update, delete |
mentio.alerts |
list, create, get, update, delete, test, run |
mentio.channels |
list, create, get, update, delete, test, rotate_secret, deliveries |
mentio.analytics |
summary, series, breakdown, share_of_voice |
mentio.company |
get, update |
mentio.api_keys |
create, list, revoke |
mentio.system |
health |
The generated low-level client and models live under mentio.api and mentio.models for anything the facade does not cover.
MCP server
The same API is available to Claude Code, Cursor, Codex, claude.ai and ChatGPT as tools:
claude mcp add --transport http mentio https://mcp.mentio.dev/mcp
Guide: docs.mentio.dev/mcp.
Requirements
- Python 3.11+
- A Mentio API key
Links
- Documentation and the Python guide
- API reference and the OpenAPI document
- Dashboard
- TypeScript SDK, CLI, Claude Code skills
This repository is published from the Mentio monorepo on every release; regenerate from a checkout with pnpm --filter @mentio-dev/sdk-python generate (needs uv).
License
MIT.
1 maintainer
Metadata
1 maintainer
Release files for mentio 0.14.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mentio-0.14.0.tar.gz | 323.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mentio-0.14.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.1 MB
Release files / mentio-0.14.0.tar.gz
| Download URL | mentio-0.14.0.tar.gz |
|---|---|
| Size | 323.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3d15df15831cab7b3bbcf9f8873f4503af935c6db80e6ac2fda805178da8c584
|
|
BLAKE2b-256 checksum How to use checksums |
d9946de60954f5d4d7a9403ef465c4f641f203add699d8c7e3e4172a1574fd3b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / mentio-0.14.0-py3-none-any.whl
| Download URL | mentio-0.14.0-py3-none-any.whl |
|---|---|
| Size | 773.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5f69473a7221faa6011d48279d03acb61f5334ce7b44387e57d80c99ba17fd8e
|
|
BLAKE2b-256 checksum How to use checksums |
c608560a6454a73f7cd3bf84186b1b5c8b696f1b23d2605ac31c73ae7fa2a6b6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.1 {"installer":{"name":"uv","version":"0.13.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for mentio 0.14.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
