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ètreTypeObligatoireDescription
account_idstringOuiId of the account, from Get account.
alert_idstringOuiId of the alert, from List alerts.
limitintegerNonMentions per page, up to 1000. The default is 20; a small limit answers faster.
cursorstringNonThe cursor parameter of _links.more.href in the previous response, to read older mentions.
since_idintegerNonOnly 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_datestringNonOnly 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_datestringNonIgnores the mentions published before this date-time. Only together with before_date.
folderstringNonOnly the mentions of this folder.Valeurs : inbox, archive, spam, trash
unreadintegerNon1 returns only unread mentions. Not combinable with favorite, q or tone.Valeurs : 0, 1
favoriteintegerNon1 returns only favorite mentions. Not combinable with folder spam or trash.Valeurs : 0, 1
toneintegerNonOnly the mentions of this tone: -1 negative, 0 neutral, 1 positive.Valeurs : -1, 0, 1
sourcestringNonOnly the mentions of this source code, from the alert_sources of Get app data. Only for plans with search access.
languagesstringNonOnly the mentions in this language code, such as en, from the alert_languages of Get app data.
countriesstringNonOnly the mentions from this country code, such as US, from the alert_countries of Get app data.
include_childrenintegerNon1 also returns the child mentions.Valeurs : 0, 1
sortstringNonSort order of the mentions. Only for plans with search access.Valeurs : published_at, author_influence.score, direct_reach, cumulative_reach, domain_reach
qstringNonKeywords, 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.
timezonestringNonTime 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

Voir les 10 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.