The Shares API from Mention — 5 operations over the join between an account and an alert. Share is the authorization primitive AND the lifecycle owner of an alert: deleting the last share deletes the alert and everything it collected.
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-shares-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 Shares 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: Shares
description: Which accounts an alert is shared with.
paths:
/accounts/{account_id}/alerts/{alert_id}/shares:
get:
operationId: listAlertShares
summary: Fetch all shares of an alert
description: Lists every share object on the alert — that is, every account the alert is shared with.
tags:
- Shares
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/share/GetShares.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- name: alert_id
in: path
required: true
description: ID of the alert.
schema:
type: integer
example: 112233
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
responses:
'200':
description: A list of shares.
content:
application/json:
schema:
$ref: '#/components/schemas/ShareList'
'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'
post:
operationId: createAlertShare
summary: Create a share
description: Creates a share object linking another account to this alert. The account_id in the body is the public id of the account the alert is shared with.
tags:
- Shares
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/share/PostShare.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- name: alert_id
in: path
required: true
description: ID of the alert.
schema:
type: integer
example: 112233
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ShareCreate'
example:
account_id: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
responses:
'200':
description: The created share.
content:
application/json:
schema:
$ref: '#/components/schemas/ShareEnvelope'
'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'
/accounts/{account_id}/alerts/{alert_id}/shares/{share_id}:
get:
operationId: getShare
summary: Fetch a share
description: Retrieves a single share object on an alert.
tags:
- Shares
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/share/GetShare.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- name: alert_id
in: path
required: true
description: ID of the alert.
schema:
type: integer
example: 112233
- name: share_id
in: path
required: true
description: ID of the share object.
schema:
type: integer
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
responses:
'200':
description: The share.
content:
application/json:
schema:
$ref: '#/components/schemas/ShareEnvelope'
'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: updateShare
summary: Update a share
description: Updates an existing share, typically to block an account's access to the alert.
tags:
- Shares
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/share/PutShare.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- name: alert_id
in: path
required: true
description: ID of the alert.
schema:
type: integer
example: 112233
- name: share_id
in: path
required: true
description: ID of the share object.
schema:
type: integer
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ShareUpdate'
example:
blocked: false
responses:
'200':
description: The updated share.
content:
application/json:
schema:
$ref: '#/components/schemas/ShareEnvelope'
'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: deleteShare
summary: Delete a share
description: 'Deletes the share object linking an account to an alert. Team admin rights are required to delete someone else''s share. There is no delete-alert operation: when the last share on an alert is deleted, the alert itself is deleted.'
tags:
- Shares
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/share/DeleteShare.html
parameters:
- name: account_id
in: path
required: true
description: ID of the account.
schema:
type: string
example: 12345_69gjjsg4itgkcco040okwsck700o4w8gsco0k4kco0s4scw8o0
- name: alert_id
in: path
required: true
description: ID of the alert.
schema:
type: integer
example: 112233
- name: share_id
in: path
required: true
description: ID of the share object.
schema:
type: integer
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
responses:
'204':
description: The share 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:
schemas:
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
ShareCreate:
type: object
required:
- account_id
properties:
account_id:
type: string
description: Public id of the account the alert is shared with.
ShareEnvelope:
type: object
properties:
share:
$ref: '#/components/schemas/Share'
ShareList:
type: object
properties:
shares:
type: array
items:
$ref: '#/components/schemas/Share'
_links:
$ref: '#/components/schemas/Links'
Share:
type: object
title: Alert share
description: The link between an account and an alert. Deleting the last share deletes the alert.
properties:
id:
type: string
account:
$ref: '#/components/schemas/Account'
role:
type: string
blocked:
type: boolean
permissions:
type: object
additionalProperties:
type: boolean
created_at:
type: string
weight:
type: integer
Links:
type: object
title: Pagination links
description: Hypermedia links for cursor pagination. more points at older items and pull at newer items; each is present only when applicable.
properties:
more:
$ref: '#/components/schemas/Link'
pull:
$ref: '#/components/schemas/Link'
ShareUpdate:
type: object
properties:
blocked:
type: boolean
description: Blocks the account's access to the alert.
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
Link:
type: object
properties:
href:
type: string
description: Relative URL to follow.
params:
type: object
description: The query string parameters encoded in href.
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
responses:
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'
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'
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'
PaymentRequired:
description: Payment required — the account's plan does not cover this request.
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
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