Lister les mentions avec l'API Mention
Liste les mentions collectées par une alerte, avec titre, texte, URL, source, langue, tonalité et dossier. La réponse contient _links.more, dont le href porte le curseur des mentions plus anciennes. Certains filtres ne peuvent pas être combinés, comme chacun l'indique.
- Identifiant
- mention_list_mentions
L'appel
POST https://connect.reportei.com/api/tools/mention_list_mentions/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>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| account_id | string | Oui | Id of the account, from Get account. |
| alert_id | string | Oui | Id of the alert, from List alerts. |
| limit | integer | Non | Mentions per page, up to 1000. The default is 20; a small limit answers faster. |
| cursor | string | Non | The cursor parameter of _links.more.href in the previous response, to read older mentions. |
| since_id | integer | Non | Only the mentions found after the mention with this id, from List mentions, sent as a number. Not combinable with before_date, not_before_date or cursor. |
| before_date | string | Non | Only the mentions published before this date-time, for example 2026-01-31T00:00:00.0+00:00. The mentions come ordered by publication date. |
| not_before_date | string | Non | Ignores the mentions published before this date-time. Only together with before_date. |
| folder | string | Non | Only the mentions of this folder.Valeurs : inbox, archive, spam, trash |
| unread | integer | Non | 1 returns only unread mentions. Not combinable with favorite, q or tone.Valeurs : 0, 1 |
| favorite | integer | Non | 1 returns only favorite mentions. Not combinable with folder spam or trash.Valeurs : 0, 1 |
| tone | integer | Non | Only the mentions of this tone: -1 negative, 0 neutral, 1 positive.Valeurs : -1, 0, 1 |
| source | string | Non | Only the mentions of this source code, from the alert_sources of Get app data. Only for plans with search access. |
| languages | string | Non | Only the mentions in this language code, such as en, from the alert_languages of Get app data. |
| countries | string | Non | Only the mentions from this country code, such as US, from the alert_countries of Get app data. |
| include_children | integer | Non | 1 also returns the child mentions.Valeurs : 0, 1 |
| sort | string | Non | Sort order of the mentions. Only for plans with search access.Valeurs : published_at, author_influence.score, direct_reach, cumulative_reach, domain_reach |
| q | string | Non | Keywords, and filters that the other arguments cannot combine, for example nasa source:(facebook OR twitter) tone:(neutral OR positive) published_at:[2026-01-01 TO 2026-01-31]. Only for plans with search access. |
| timezone | string | Non | Time zone of the dates in q, for example America/Sao_Paulo. |
Connexions possibles
Votre client connecte son compte Mention une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/mention_list_mentions. Il devient la définition de tool de votre agent sans conversion.
Autres tools Mention
- Obtenir le compteGETRenvoie le compte Mention de la connexion avec id, nom, e-mail et langue. L'id est l'account_id que demandent les autres outils.
- Obtenir les données de l'appGETRenvoie les listes de référence de Mention : alert_languages, alert_countries et alert_sources, dont les clés sont les codes que prennent les alertes et les filtres de mentions, ainsi que alert_tones et mention_folders.
- Lister les alertesGETListe les alertes du compte avec id, nom, requête, langues, sources et nombre de mentions par dossier. Quand il y a plus d'alertes, la réponse contient _links.more avec le curseur de la page suivante.
- Créer une alertePOSTCrée une alerte, qui commence à collecter les mentions correspondant à sa requête, et la renvoie avec son id. Les mentions collectées comptent dans le quota du forfait Mention.
- Mettre à jour une alertePUTMet à jour une alerte, généralement pour affiner sa requête, et la renvoie. Seuls les champs envoyés changent. Une requête envoyée remplace l'actuelle et exige son type.
- Obtenir une mentionGETRenvoie une mention avec titre, texte, URLs, source, langue, tonalité, dossier, les indicateurs lue et favorite, ses tâches et la première page de ses mentions enfants.
- Mettre à jour une mentionPUTClasse une mention : la marque comme lue ou favorite, la déplace dans un dossier, définit sa tonalité ou la tague, et la renvoie. Seuls les champs envoyés changent. Le contenu d'une mention ne change jamais.
- Lister les tagsGETListe les tags d'une alerte avec id, nom, nombre de mentions et mots-clés d'étiquetage automatique. L'id est ce que prennent les tags de Mettre à jour une mention.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
