Mention tools
The 10 Mention operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- 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.
- 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.
- Create tagPOSTCreates a tag in an alert and returns it with its id. An alert holds up to 100 tags, and new mentions that contain one of the keywords are tagged automatically.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
