Get account with the Mention API
Returns the Mention account of the connection with its id, name, email and language. The id is the account_id that the other tools take.
- Identifier
- mention_get_account
The request
POST https://connect.reportei.com/api/tools/mention_get_account/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {}
}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
This tool takes no arguments.
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_account. It becomes your agent's tool definition with no conversion.
Other Mention tools
- 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.
- Get mentionGETReturns 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.
- 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.
