Brand Mentions
Une mention de marque est une page web publique dont le texte cite la marque, qu’il s’agisse d’un test, d’un article de presse, d’un fil de forum ou d’une fiche produit, accompagnée du passage autour du nom, de l’auteur, de la langue, du pays et de la date de publication. Notées selon le sentiment et classées par autorité de la page et du domaine, ces pages montrent où l’on parle d’une marque, dans quel sens penche la conversation et quelles sources pèsent le plus, ce qui nourrit le suivi de l’e-réputation, la mesure des retombées presse et la veille concurrentielle.
Fonctionnalités de la Brand Mentions API
- Recherche par mot-clé et correspondance exactequery accepte une marque, un produit ou un sujet de 100 caractères au plus ; une expression entre guillemets droits est recherchée telle quelle.
- Filtre par type de sitecontent_type limite les résultats à news, blogs, message-boards, ecommerce ou organization, et page_types indique le type de chaque résultat.
- Sentiment par passagesentiment répartit le passage entre positif, négatif et neutre pour un total de 1, et emotions note la joie, l’amour, l’amusement, le partage, la tristesse et la colère de 0 à 1.
- Autorité et qualitédomain_rank et page_rank mesurent l’autorité de 0 à 1000, tandis que spam_score et content_quality_score aident à écarter les pages pauvres ou douteuses.
- Le contexte de chaque mentiontitle, le passage dans text, author_name, language, country, published_at lorsqu’il est indiqué et fetched_at situent la mention dans le temps et l’espace.
- Jusqu’à 1 000 pages par requêteresults_limit va de 1 à 1000 pour faire le tour de la présence d’une marque sur le web en une seule fois.
Paramètres de la Brand Mentions API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Marque, produit ou sujet à rechercher (100 caractères au plus). Une expression entre guillemets droits est recherchée à l’identique. |
content_type | Facultatif | Type de site d’où proviennent les mentions : news, blogs, message-boards, ecommerce ou organization. |
results_limit | Facultatif | Nombre de pages à renvoyer (1 à 1000). Valeur par défaut : 100. |
Comment utiliser la Brand Mentions API
Envoyez un nom de marque ou de produit et lisez les mentions ligne par ligne.
- Envoyez {"query": "notion", "results_limit": 100} en POST à /v1/brand-monitoring/mentions.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les pages dans results.items et utilisez results.next_cursor pour la page suivante tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"notion","results_limit":100}'Cas d’usage de la Brand Mentions API
- Suivi de l’e-réputation : Repérez les passages où sentiment.negative dépasse le score positif et classez-les par domain_rank de la page pour décider lesquels examiner en premier.
- Suivi des retombées presse : Réglez content_type sur news et relevez author_name, published_at et domain_rank pour savoir quels médias ont couvert un lancement et avec quelle portée.
- Comparaison entre marques : Lancez la même requête pour votre marque et pour un concurrent, puis comparez les types de sites, les pays et la répartition du sentiment des mentions.
- La voix des communautés : Limitez content_type à message-boards pour rassembler les fils où les utilisateurs décrivent un produit avec leurs propres mots.
Conseils d’expert pour la Brand Mentions API
- Mettez les noms de marque composés entre guillemets, par exemple "notion ai", pour cibler l’expression exacte.
- Pour juger de la fraîcheur, privilégiez published_at et rabattez-vous sur fetched_at sinon : beaucoup de pages n’affichent pas de date de publication.
- Retirez les lignes au spam_score élevé ou au content_quality_score faible avant d’agréger le sentiment, pour que les pages pauvres ne faussent pas le résultat.
- Associez-la à Brand Sentiment Analysis API lorsque vous avez besoin à la fois du détail par page et des proportions globales.
API associées
En complément de la Brand Mentions API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Brand Monitoring.
- Brand Sentiment Analysis API — Résumez sur une ligne la façon dont le web parle d’une marque ou d’un sujet, avec le nombre de pages par sentiment et par émotion et les principaux domaines, pays et langues de chaque groupe.