Get mention with the Mention API
Returns one mention with title, text, URLs, source, language, tone, folder, the read and favorite flags, its tasks and the first page of its child mentions.
- Identifier
- mention_get_mention
The request
POST https://connect.reportei.com/api/tools/mention_get_mention/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"account_id": "<account_id>",
"alert_id": "<alert_id>",
"mention_id": "<mention_id>"
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| account_id | string | Yes | Id of the account, from Get account. |
| alert_id | string | Yes | Id of the alert, from List alerts. |
| mention_id | string | Yes | Id of the mention, from List mentions. |
Supported connections
Your customer connects their Mention account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/mention_get_mention. It becomes your agent's tool definition with no conversion.
Other Mention tools
- Get accountGETReturns the Mention account of the connection with its id, name, email and language. The id is the account_id that the other tools take.
- Get app dataGETReturns the reference lists of Mention: alert_languages, alert_countries and alert_sources, whose keys are the codes that alerts and mention filters take, plus alert_tones and mention_folders.
- List alertsGETLists the alerts of the account with id, name, query, languages, sources and mention counts per folder. When there are more alerts, the response has _links.more with the cursor of the next page.
- Create alertPOSTCreates an alert, which starts collecting the mentions that match its query, and returns it with its id. Collected mentions count against the quota of the Mention plan.
- Update alertPUTUpdates an alert, usually to refine its query, and returns it. Only the fields sent change. A query sent replaces the current one and needs its type.
- List mentionsGETLists the mentions an alert collected, with title, text, URL, source, language, tone and folder. The response has _links.more, whose href carries the cursor of the older mentions. Some filters cannot be combined, as each one says.
- Update mentionPUTCurates a mention: marks it read or favorite, moves it to a folder, sets its tone or tags it, and returns it. Only the fields sent change. The content of a mention never changes.
- List tagsGETLists the tags of an alert with id, name, mention count and auto-tagging keywords. The id is what the tags of Update mention take.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
