The Tags API from Mention — 4 operations for the labels scoped to an alert, including up to five auto-tagging keywords per tag that label incoming mentions automatically. Limits: 100 tags per alert, 20 characters per name.
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:mention-tags-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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 Tags 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: Tags
description: Tags and auto-tagging keywords on an alert.
paths:
/accounts/{account_id}/alerts/{alert_id}/tags:
get:
operationId: listAlertTags
summary: Fetch all tags of an alert
description: Lists the tags defined on an alert, with the number of mentions carrying each tag.
tags:
- Tags
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/tag/GetTags.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 tags.
content:
application/json:
schema:
$ref: '#/components/schemas/TagList'
'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: createAlertTag
summary: Create a tag
description: Creates a tag available to every mention of the alert. An alert is limited to 100 tags, a tag name to 20 characters, and the auto-tagging keywords list to 5 keywords.
tags:
- Tags
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/tag/PostTag.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/TagWrite'
example:
name: space innovation
responses:
'200':
description: The created tag.
content:
application/json:
schema:
$ref: '#/components/schemas/TagEnvelope'
'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}/tags/{tag_id}:
put:
operationId: renameTag
summary: Rename a tag
description: Modifies an existing tag's label or auto-tagging keywords. Mentions stay linked to the tag by id, so renaming a tag does not detach it from the mentions already carrying it.
tags:
- Tags
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/tag/PutTag.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: tag_id
in: path
required: true
description: ID of the tag.
schema:
type: integer
example: 46468
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/TagWrite'
example:
name: space new technos
responses:
'200':
description: The updated tag.
content:
application/json:
schema:
$ref: '#/components/schemas/TagEnvelope'
'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: deleteTag
summary: Delete a tag
description: Deletes a tag from the alert.
tags:
- Tags
externalDocs:
description: Mention API reference
url: https://dev.mention.com/current/src/account/alert/tag/DeleteTag.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: tag_id
in: path
required: true
description: ID of the tag.
schema:
type: integer
example: 46468
- $ref: '#/components/parameters/AcceptVersion'
- $ref: '#/components/parameters/AcceptLanguage'
responses:
'204':
description: The tag 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'
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'
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'
NotFound:
description: The resource does not exist.
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'
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
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'
TagWrite:
type: object
properties:
name:
type: string
maxLength: 20
keywords:
type: array
maxItems: 5
items:
type: string
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
TagList:
type: object
properties:
tags:
type: array
items:
$ref: '#/components/schemas/Tag'
_links:
$ref: '#/components/schemas/Links'
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
Tag:
type: object
title: Tag
properties:
id:
type: integer
example: 46468
name:
type: string
maxLength: 20
example: space innovation
mention_count:
type: integer
keywords:
type: array
maxItems: 5
items:
type: string
description: Auto-tagging keywords; new mentions containing them are tagged automatically.
TagEnvelope:
type: object
properties:
tag:
$ref: '#/components/schemas/Tag'
parameters:
AcceptLanguage:
name: Accept-Language
in: header
required: false
description: Language used for translated resource fields.
schema:
type: string
example: fr
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'
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