brand-monitoring/
mentions

Trouvez les pages web qui citent une marque, un produit ou un sujet et obtenez pour chacune le passage concerné, l’auteur, la date, le type de site, les scores de sentiment et l’autorité.

Brand Mentions API

Mentions sur tout le web
Sentiment par passage
Filtre par type de site
Autorité et score de spam
10 crédits par requête + 0,02 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
queryObligatoireMarque, produit ou sujet à rechercher (100 caractères au plus). Une expression entre guillemets droits est recherchée à l’identique.
content_typeFacultatifType de site d’où proviennent les mentions : news, blogs, message-boards, ecommerce ou organization.
results_limitFacultatifNombre 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.

  1. Envoyez {"query": "notion", "results_limit": 100} en POST à /v1/brand-monitoring/mentions.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

Combinez les données Brand Monitoring avec les données publiques d’autres plateformes sociales prises en charge.

Brand Mentions API — FAQ

Brand Mentions API trouve les pages web qui citent une marque, un produit ou un sujet et renvoie pour chacune le passage concerné, l’auteur, la date, le type de site, les scores de sentiment et d’émotion ainsi que les scores d’autorité et de spam.

Les pages web indexées dont le texte correspond à votre recherche : articles de presse, tests sur des blogs, forums, fiches produit de sites marchands, sites d’entreprise, etc. content_type permet d’en choisir un seul type.

Sur le passage qui entoure la mention : sentiment donne les parts positive, négative et neutre pour un total de 1, et emotions un score de 0 à 1 pour chacune des six émotions.

Oui. Placez le nom entre guillemets dans query pour obtenir une correspondance exacte.

10 crédits par requête, plus 0,02 crédit par page renvoyée. Les 10 crédits s’appliquent aussi lorsqu’aucune page n’est trouvée.