The Accounts API from Mention — 5 operations for account CRUD and identity resolution — createAccount, getAccount, updateAccount, deleteAccount and getMe. An access token can only act on its own account; cross-account calls return 403.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/mention-accounts-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Mention Accounts API
description: 'The Mention API is a JSON-based, RESTful API that gives programmatic access to the media monitoring and social listening platform: alerts (the keyword queries Mention crawls for), mentions (the results it finds), curation, tags, tasks, alert sharing, authors and influencers, and aggregate statistics.'
version: '1.21'
contact:
name: Mention Support
url: https://en.support.mention.com/
license:
name: Proprietary
url: https://mention.com/en/terms-and-conditions/
servers:
- url: https://api.mention.net/api
description: Mention API — the base URL named in Mention's own reference documentation.
- url: https://api.mention.com/api
description: Alternate host observed answering the same API (returns the same OAuth2 challenge).
security:
- bearerAuth: []
- accessTokenQuery: []
- oauth2: []
tags:
- name: Accounts
description: Mention accounts and the authenticated identity.
paths:
/accounts:
post:
operationId: createAccount
summary: Create an account
description: Creates a new Mention account. The password must be at least 6 characters long and mix letters and figures. The optional client property records the name of the application registering the user.
tags:
- Accounts
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/PostAccount.html
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AccountCreate'
example:
name: John Smith
email: j.smith@nasa.com
password: REDACTED_EXAMPLE_PASSWORD
language_code: en
responses:
'200':
description: The created account.
content:
application/json:
schema:
$ref: '#/components/schemas/AccountEnvelope'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
parameters:
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
/accounts/me:
get:
operationId: getMe
summary: Fetch my account
description: Fetches all account details for the account that owns the access token used on the request. This is the standard way to resolve the account_id required by every other endpoint.
tags:
- Accounts
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/GetAccountMe.html
responses:
'200':
description: The authenticated account.
content:
application/json:
schema:
$ref: '#/components/schemas/AccountEnvelope'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
parameters:
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
/accounts/{account_id}:
get:
operationId: getAccount
summary: Fetch an account
description: Retrieves details for the given account. An access token cannot read another person's account, even when that account was created through this API.
tags:
- Accounts
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/GetAccount.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
responses:
'200':
description: The account.
content:
application/json:
schema:
$ref: '#/components/schemas/AccountEnvelope'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
put:
operationId: updateAccount
summary: Update an account
description: Modifies an existing account. Only the account that owns the access token can be modified. Changing the password requires sending both old_password and new_password rather than password.
tags:
- Accounts
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/PutAccount.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AccountUpdate'
example:
name: John Smith
email: j.smith@nasa.com
responses:
'200':
description: The updated account.
content:
application/json:
schema:
$ref: '#/components/schemas/AccountEnvelope'
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
delete:
operationId: deleteAccount
summary: Delete an account
description: Deletes an account. As with GET and PUT, an access token cannot delete another person's account.
tags:
- Accounts
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/DeleteAccount.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
responses:
'204':
description: The account was deleted.
'400':
$ref: '#/components/responses/ValidationError'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
components:
responses:
Unauthorized:
description: Access was denied — missing or invalid access token.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthError'
NotFound:
description: The resource does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthError'
PaymentRequired:
description: Payment required — the account's plan does not cover this request.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthError'
Forbidden:
description: Access was denied — the token is valid but not permitted on this resource.
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthError'
ValidationError:
description: Invalid input — query string, body or parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationError'
RateLimited:
description: Rate limited. The response carries an X-Rate-Limit-Reset header holding the unix timestamp at which the limit resets.
headers:
X-Rate-Limit-Reset:
description: Unix timestamp at which the rate limit resets.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/OAuthError'
parameters:
AcceptVersion:
name: Accept-Version
in: header
required: false
description: API version to use for this request, e.g. 1.21. When omitted, the version configured in the app's settings applies.
schema:
type: string
example: '1.21'
AcceptLanguage:
name: Accept-Language
in: header
required: false
description: Language used for translated resource fields.
schema:
type: string
example: fr
schemas:
AccountCreate:
type: object
title: Account create
required:
- name
- email
- password
- language_code
properties:
name:
type: string
email:
type: string
format: email
minLength: 2
maxLength: 255
phone:
type: string
password:
type: string
minLength: 6
description: At least 6 characters, mixing letters and figures.
language_code:
type: string
description: Two character language code; valid values come from app/data.
client:
type: string
description: Name of the application registering the user. Not updatable.
AccountUpdate:
type: object
title: Account update
description: Any property may be omitted. Changing the password requires old_password and new_password rather than password.
properties:
name:
type: string
email:
type: string
format: email
phone:
type: string
language_code:
type: string
old_password:
type: string
new_password:
type: string
AccountEnvelope:
type: object
properties:
account:
$ref: '#/components/schemas/Account'
OAuthError:
type: object
title: OAuth2 error
description: Error envelope returned by the API gateway and the OAuth2 endpoints.
properties:
error:
type: string
example: access_denied
error_description:
type: string
example: OAuth2 authentication required
Account:
type: object
title: Account
properties:
id:
type: string
name:
type: string
email:
type: string
format: email
language_code:
type: string
created_at:
type: string
updated_at:
type: string
avatar_url:
type: string
timezone:
type: string
grouped_email_notification:
type: boolean
default_email_notification_frequency:
type: string
default_desktop_notification_frequency:
type: string
default_push_notification_frequency:
type: string
permissions:
type: object
additionalProperties: true
ValidationError:
type: object
title: Validation error
description: Validation errors on POST and PUT requests are returned with a 400 status code. Field-level messages are keyed by field name under form.children and are intended to be displayed directly to the end user when they result from a form submission.
properties:
form:
type: object
properties:
errors:
type: array
items:
type: string
description: Request-wide error messages.
children:
type: object
description: Field-specific error messages, keyed by field name.
additionalProperties:
type: object
properties:
errors:
type: array
items:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: Access token passed in the Authorization header, prefixed with 'Bearer '. This is the preferred method. A token for your own account is available at the bottom of your app's settings page.
accessTokenQuery:
type: apiKey
in: query
name: access_token
description: The same access token passed in the query string. Supported but discouraged, as it puts the credential in the URL.
oauth2:
type: oauth2
description: 'Authorization-code flow used to obtain an access token for a third party''s Mention account. No scopes are defined: a granted token carries full access to the authorizing account.'
flows:
authorizationCode:
authorizationUrl: https://web.mention.com/authorize
tokenUrl: https://web.mention.net/oauth/v2/token
scopes: {}
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/
x-generated-from: https://dev.mention.com/current/
x-generated-by: api-evangelist-enrichment-2026-08-13