Mention is a social listening and media monitoring platform that tracks brand mentions across the web and social media. The Mention REST API lets you manage accounts, configure monitoring alerts, and read the mentions, authors, tags, and tasks those alerts produce, so you can pull media-monitoring data into Nexla and push updates back to Mention.
Power end-to-end data operations for your Mention API with Nexla. Our bi-directional Mention connector is purpose-built for Mention, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Mention or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Mention workflows fast, secure, and fully governed.
Features
Type: API
SourceDestination
Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
Before creating a Mention credential, you need an access token for your Mention account. The Mention API uses bearer token authentication, and the token is passed in the HTTP Authorization header.
To obtain an access token, follow these steps:
Sign in to your Mention account.
Open the Mention developer portal and create an application to register your integration. Once the application is created, an access token is available at the bottom of the application's details page.
Copy the access token and store it securely. This token grants access to your Mention account data and should be treated as a secret.
When calling the API, the token is sent in the Authorization header prefixed with Bearer (for example, Authorization: Bearer <access_token>). If your token is ever compromised, revoke it in your Mention developer portal and generate a new one. For detailed information about authentication and the available endpoints, see the Mention API Reference.
After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
Enter your Mention access token in the API Key Value field. This is the bearer token you obtained in Prerequisites and is sent in the Authorization header for all API requests to the Mention API.
The access token provides access to your Mention account data and should be kept confidential. If your token is compromised, revoke it in your Mention developer portal and generate a new one.
For detailed information about authentication and available endpoints, see the Mention API Reference.
Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Mention connector tile, then select the credential that will be used to connect to Mention, and click Next; or, create a new Mention credential for use in this flow.
Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Mention endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.
[Rest API] Retrieve the authenticated user's account
This endpoint template retrieves the Mention account associated with the API token used to authenticate the request.
Use this template to confirm which account your credential is tied to and to read that account's profile details before configuring alert-level flows.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Retrieve a specific account
This endpoint template retrieves the details of a specific Mention account by its account ID.
Provide the account Id for the account you want to fetch. This returns the account's profile and configuration data.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch account statistics
This endpoint template retrieves usage and performance statistics for a specific Mention account.
Provide the account Id, and optionally a Date Range to scope the statistics to a specific window.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch all alerts for an account
This endpoint template retrieves all alerts configured under a specific Mention account. Alerts define the keywords and sources that Mention monitors.
Provide the account Id. The Limit and Offset parameters can be used to page through large numbers of alerts.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch a specific alert
This endpoint template retrieves the configuration and details of a single alert within an account.
Provide the account Id and the Alertid of the alert you want to fetch.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch mentions for an alert
This endpoint template retrieves the mentions captured by a specific alert. Mentions are the individual results Mention finds matching an alert's query.
Provide the account Id and Alertid. The Limit parameter caps the number of results and Before can be used to page backward through the mention timeline.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Stream mentions for an alert
This endpoint template retrieves a continuous stream of mentions for a specific alert, ordered for incremental consumption.
Provide the account Id and Alertid to stream newly captured mentions for that alert.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Mark all mentions as read for an alert
This endpoint template marks every mention under a specific alert as read.
Provide the account Id and Alertid for the alert whose mentions should be marked read.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch a specific mention
This endpoint template retrieves the full details of a single mention within an alert.
Provide the account Id, Alertid, and Mentionid identifying the mention to fetch.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch children of a mention
This endpoint template retrieves the child mentions (such as replies or related items) grouped under a parent mention.
Provide the account Id, Alertid, and Mentionid of the parent mention.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch all shares for an alert
This endpoint template retrieves all shares configured for a specific alert. Shares grant other users access to an alert.
Provide the account Id and Alertid to list that alert's shares.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch a specific share
This endpoint template retrieves the details of a single share on an alert.
Provide the account Id, Alertid, and Shareid identifying the share to fetch.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch preferences for an alert
This endpoint template retrieves the notification and display preferences configured for a specific alert.
Provide the account Id and Alertid to read that alert's preferences.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch all tags for an alert
This endpoint template retrieves all tags defined for a specific alert. Tags are used to categorize mentions.
Provide the account Id and Alertid to list the alert's tags.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch authors/influencers for an alert
This endpoint template retrieves the authors and influencers associated with the mentions captured by a specific alert.
Provide the account Id and Alertid to fetch the authors and influencers for that alert.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch all tasks for an alert
This endpoint template retrieves all tasks associated with a specific alert. Tasks track follow-up work on mentions.
Provide the account Id and Alertid to list the alert's tasks.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch a mention's tasks
This endpoint template retrieves all tasks associated with a specific mention.
Provide the account Id, Alertid, and Mentionid to list the tasks attached to that mention.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch a specific task on a mention
This endpoint template retrieves the details of a single task attached to a mention.
Provide the account Id, Alertid, Mentionid, and Taskid identifying the task to fetch.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Fetch application metadata
This endpoint template retrieves application-level metadata for the Mention API, such as reference data used across the application.
This template does not require any additional path parameters.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.
Mention data sources can also be manually configured to ingest data from any valid Mention API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Mention data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.
Click the + icon on the Nexset that will be sent to the Mention destination, and select the Send to Destination option from the menu. Select the Mention connector from the list of available destination connectors, then select the credential that will be used to connect to Mention, and click Next; or, create a new Mention credential for use in this flow.
Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Mention endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.
[Rest API] Create an account
This endpoint template creates a new Mention account using records from a Nexset.
Each record is sent as a JSON request body describing the account to create.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Update an account
This endpoint template updates an existing Mention account using records from a Nexset.
Provide the account Id to update. Each record is sent as a JSON request body containing the fields to change.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Delete an account
This endpoint template deletes a Mention account.
Provide the account Id identifying the account to delete.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Create an alert
This endpoint template creates a new alert under a specific account. Alerts define the keywords and sources Mention monitors.
Provide the account Id. Each record is sent as a JSON request body describing the alert to create.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Update an alert
This endpoint template updates an existing alert.
Provide the account Id and Alertid. Each record is sent as a JSON request body containing the fields to change.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Delete an alert
This endpoint template deletes an alert from an account.
Provide the account Id and Alertid identifying the alert to delete.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Pause an alert
This endpoint template pauses an active alert so that it stops collecting new mentions.
Provide the account Id and Alertid of the alert to pause.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Unpause an alert
This endpoint template resumes a paused alert so that it begins collecting mentions again.
Provide the account Id and Alertid of the alert to unpause.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Curate (update) a mention
This endpoint template curates a mention, updating its attributes such as tags, sentiment, or read state.
Provide the account Id, Alertid, and Mentionid. Each record is sent as a JSON request body containing the fields to update.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Create an alert share
This endpoint template creates a new share on an alert, granting another user access to it.
Provide the account Id and Alertid. Each record is sent as a JSON request body describing the share to create.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Update a share
This endpoint template updates an existing share on an alert.
Provide the account Id, Alertid, and Shareid. Each record is sent as a JSON request body containing the fields to change.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Delete a share
This endpoint template deletes a share from an alert.
Provide the account Id, Alertid, and Shareid identifying the share to delete.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Update preferences for an alert
This endpoint template updates the notification and display preferences for a specific alert.
Provide the account Id and Alertid. Each record is sent as a JSON request body containing the preference fields to update.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Create a tag for an alert
This endpoint template creates a new tag on an alert for categorizing mentions.
Provide the account Id and Alertid. Each record is sent as a JSON request body describing the tag to create.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Rename a tag
This endpoint template renames an existing tag on an alert.
Provide the account Id, Alertid, and Tagid. Each record is sent as a JSON request body containing the new tag name.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Delete a tag
This endpoint template deletes a tag from an alert.
Provide the account Id, Alertid, and Tagid identifying the tag to delete.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Create a task for a mention
This endpoint template creates a new task on a mention to track follow-up work.
Provide the account Id, Alertid, and Mentionid. Each record is sent as a JSON request body describing the task to create.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Update a task on a mention
This endpoint template updates an existing task attached to a mention.
Provide the account Id, Alertid, Mentionid, and Taskid. Each record is sent as a JSON request body containing the fields to change.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
[Rest API] Delete a task on a mention
This endpoint template deletes a task from a mention.
Provide the account Id, Alertid, Mentionid, and Taskid identifying the task to delete.
For detailed information about this endpoint, its request and response structure, and available fields, see the Mention API Reference.
Mention destinations can also be manually configured to send data to any valid Mention API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks.
Mention APIs expect JSON format for create and update operations. For update operations, include the identifiers of the object to be updated (such as the account, alert, or mention ID) in the endpoint URL.
Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Mention endpoint, open the destination resource menu, and select Activate.
The Nexset data will not be sent to the Mention endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.
