# Mention

> Mention is a media monitoring and social listening platform that watches over one billion sources in real time across 42 languages. Its JSON REST API gives programmatic access to alerts (the standing keyword queries Mention crawls for), mentions (the results it finds), curation, tags, tasks, alert sharing, authors and influencers, and aggregate statistics. Mention is sold by Agorapulse SAS.

Generated by API Evangelist on 2026-08-13. Mention does not publish an llms.txt of its own — https://mention.com/llms.txt and https://dev.mention.com/llms.txt both return 404 — so this file is generated from the provider's own documentation plus the artifacts in this repository.

## Read this first

- The API base URL is `https://api.mention.net/api`. The reference states it plainly: "Resource URLs given in the documentation must be prefixed with https://api.mention.net/api". `https://api.mention.com/api` answers the same API and returns the same OAuth2 challenge, but `api.mention.net` is the documented host.
- The developer reference lives at https://dev.mention.com/current/ — note the `/current/` prefix. The bare `https://dev.mention.com/` 301-redirects there, but every deep link written without `/current/` returns 404.
- Authentication is a bearer token: `Authorization: Bearer <access_token>`. A token for your own account is printed at the bottom of your app's settings page after you register an API client. A token for someone else's account comes from the OAuth2 authorization-code flow.
- Send `Accept-Version: 1.21` on every request. Without it you get whatever version your app's settings record, which is account state rather than a documented default.
- Mention publishes no OpenAPI, no SDK in any language, no MCP server, no agent card, no webhooks and no security.txt. The OpenAPI definitions in this repository were reconstructed by API Evangelist from Mention's own HTML reference.
- API access is a paid add-on. The single published plan (Company) lists "API access for custom integrations" as "Not included in this plan — available as a paid add-on."

## Documentation

- [API reference](https://dev.mention.com/current/): the full Mention API reference, GitBook-rendered, server-side HTML.
- [Overview](https://dev.mention.com/current/src/index.html): authentication, request/response format, methods, errors, validation, date format, language, base URL, rate limits, versioning.
- [OAuth2](https://dev.mention.com/current/src/appendix/OAuth2.html): the authorization-code flow, authorize and token endpoints, parameter tables.
- [Errors](https://dev.mention.com/current/src/appendix/Errors.html): the status vocabulary and the form/children validation envelope.
- [Rate limits](https://dev.mention.com/current/src/appendix/Ratelimits.html): 429 plus the X-Rate-Limit-Reset header.
- [Languages](https://dev.mention.com/current/src/appendix/Languages.html): the language vocabulary.
- [API change log](https://dev.mention.com/current/src/Changelog.html): dated versions 1.1 through 1.21.
- [API access explained](https://en.support.mention.com/en/articles/1904644-api-access-explained): the help-center article carrying the only published numeric rate limits.
- [Help center](https://en.support.mention.com/)
- [Product release notes](https://whatsnew.mention.com)
- [Status page](https://status.mention.com/): App, API and Website components.

## APIs

- [Alerts](https://dev.mention.com/current/src/account/alert/index.html): create, read, update, pause and unpause the standing keyword queries. `listAlerts`, `createAlert`, `getAlert`, `updateAlert`, `pauseAlert`, `unpauseAlert`, `getAlertPreferences`, `updateAlertPreferences`.
- [Mentions](https://dev.mention.com/current/src/account/alert/mention/index.html): search, read, curate and stream results. `listMentions`, `getMention`, `curateMention`, `getMentionChildren`, `markAllMentionsRead`, `streamMentions`.
- [Accounts](https://dev.mention.com/current/src/account/index.html): account CRUD and identity resolution. `createAccount`, `getAccount`, `updateAccount`, `deleteAccount`, `getMe`.
- [Shares](https://dev.mention.com/current/src/account/alert/share/index.html): who can see an alert. `listAlertShares`, `createAlertShare`, `getShare`, `updateShare`, `deleteShare`.
- [Tags](https://dev.mention.com/current/src/account/alert/tag/index.html): labels and auto-tagging keywords. `listAlertTags`, `createAlertTag`, `renameTag`, `deleteTag`.
- [Tasks](https://dev.mention.com/current/src/account/alert/mention/task/index.html): assignments on a mention. `listAlertTasks`, `createMentionTask`, `getTask`, `updateTask`, `deleteTask`.
- [Authors](https://dev.mention.com/current/src/account/alert/author/index.html): authors and influencers behind an alert's mentions. `listAuthors`.
- [Stats](https://dev.mention.com/current/src/account/stats/index.html): aggregate statistics across alerts. `getStats`.
- [App](https://dev.mention.com/current/src/app/index.html): the vocabulary service every enumerated field resolves against. `getAppData`.

## Specs

- [Mention API (full)](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/_original/mention-openapi.yml)
- [Alerts OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-alerts-api-openapi.yml)
- [Mentions OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-mentions-api-openapi.yml)
- [Accounts OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-accounts-api-openapi.yml)
- [Shares OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-shares-api-openapi.yml)
- [Tags OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-tags-api-openapi.yml)
- [Tasks OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-tasks-api-openapi.yml)
- [Authors OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-authors-api-openapi.yml)
- [Stats OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-stats-api-openapi.yml)
- [App OpenAPI](https://raw.githubusercontent.com/api-evangelist/mention/main/openapi/mention-app-api-openapi.yml)

## Operating knowledge

- [Conventions](https://raw.githubusercontent.com/api-evangelist/mention/main/conventions/mention-conventions.yml): auth style, cursor pagination through `_links.more` and `_links.pull`, partial-update PUT semantics, versioning, date format, and the absence of idempotency keys and request ids.
- [Authentication](https://raw.githubusercontent.com/api-evangelist/mention/main/authentication/mention-authentication.yml)
- [OAuth scopes](https://raw.githubusercontent.com/api-evangelist/mention/main/scopes/mention-scopes.yml): none are defined; a granted token is all-or-nothing.
- [Errors](https://raw.githubusercontent.com/api-evangelist/mention/main/errors/mention-problem-types.yml): 400/401/402/403/404/429 and the form/children validation envelope.
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/mention/main/rate-limits/mention-rate-limits.yml): create alert max(20, alertsQuota*2) per 24h; list mentions 3600 per alert per 24h.
- [Data model](https://raw.githubusercontent.com/api-evangelist/mention/main/data-model/mention-data-model.yml): the Account → Share → Alert → Mention → Task tree.
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/mention/main/lifecycle/mention-lifecycle.yml): versioning, deprecations, SLA goal and status page.
- [Changelog](https://raw.githubusercontent.com/api-evangelist/mention/main/changelog/mention-changelog.yml)
- [Conformance](https://raw.githubusercontent.com/api-evangelist/mention/main/conformance/mention-conformance.yml)
- [Plans and pricing](https://raw.githubusercontent.com/api-evangelist/mention/main/plans/mention-plans-pricing.yml)
- [Packages](https://raw.githubusercontent.com/api-evangelist/mention/main/packages/mention-packages.yml): no first-party SDK exists.
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/mention/main/skills/_index.yml)

## Gotchas an agent will hit

- Account ids are composite strings like `12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0`, not integers. Every other id is numeric. Resolve yours with `GET /accounts/me` before anything else.
- `POST /accounts/{account_id}/alerts` requires a `group_id` query string parameter since version 1.21. It was optional before.
- Alerts return an empty `stats` object by default since 1.21. Ask for counters explicitly: `?stats=unread_mentions.total,mention_folders.inbox.total`.
- There is no delete-alert operation. Delete your share on the alert; the alert is destroyed when its last share is.
- There is no endpoint for a mention's tasks. They come back inline on the mention.
- Several mention filters are entitlement-gated (`source`, `sort`, `q` need a plan with search access) and several are index-gated (an alert's `index_version` decides which filters it supports). Read `index_version` off the alert before assuming a filter exists.
- `unread` cannot be combined with `favorite`, `q` or `tone`. `since_id` cannot be combined with `before_date`, `not_before_date` or `cursor`.
- Retries are not safe. Mention documents no idempotency key, so a retried POST can duplicate an alert, tag, task or share.
- Only `X-Rate-Limit-Reset` is returned on a 429. There is no limit or remaining header, so you cannot pace yourself before exhaustion — poll conservatively or use the streaming endpoint at `https://stream.mention.net/api` (one open stream per account).
- Outside 200 and 400, error bodies are HTML by design. Do not attempt to parse them.

## Company

- [Website](https://mention.com/)
- [Media monitoring API](https://mention.com/en/media-monitoring-api/)
- [Pricing](https://mention.com/en/pricing/)
- [Terms, privacy, cookie and security policies](https://mention.com/en/terms-and-conditions/)
- [Blog](https://mention.com/en/blog/)
- [GitHub organization](https://github.com/mentionapp)
- [LinkedIn](https://www.linkedin.com/company/mention)