brand-monitoring/
sentiment

Résumez en une requête la façon dont le web parle d’une marque : les pages regroupées par sentiment et par émotion, avec le nombre de pages, les principaux sites et les pays de chaque groupe.

Brand Sentiment Analysis API

Positif, négatif, neutre
Six émotions
Principaux sites par groupe
Pays et langues
10 crédits par requête
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 Sentiment Analysis

Le sentiment d’une marque est la tonalité d’ensemble des pages web qui la citent : leur répartition entre positif, négatif et neutre, et les émotions qui dominent, de la joie et l’amour à la tristesse et la colère. Ventilé par sites, pays, langues et types de pages derrière chaque groupe, il indique si les critiques viennent de la presse, des forums ou d’un marché précis, et alimente les rapports d’e-réputation, les bilans de campagne et les comparaisons avec la concurrence.

Fonctionnalités de la Brand Sentiment Analysis API

  • Trois groupes de sentimentsentiments renvoie les groupes positif, négatif et neutre, et le mentions_count de chacun correspond au nombre de pages qui y sont classées.
  • Six catégories d’émotionemotions regroupe les mêmes pages selon leur émotion dominante : joie, amour, amusement, partage, tristesse et colère.
  • Les sites derrière chaque groupetop_domains cite jusqu’à 10 sites qui comptent le plus de pages dans le groupe et montre qui porte la conversation positive ou négative.
  • Pays, langues et types de pagescountries, languages et page_types indiquent la provenance des pages de chaque groupe. WW désigne les sites à portée mondiale, et les types incluent news, blogs ou message-boards.
  • Une ligne par marqueUne requête renvoie la ventilation complète de la recherche, prête à être enregistrée comme instantané daté.

Paramètres de la Brand Sentiment Analysis API

ParamètresObligatoireDescription
queryObligatoireMarque, produit ou sujet à analyser (100 caractères au plus). Une expression entre guillemets droits est recherchée à l’identique.

Comment utiliser la Brand Sentiment Analysis API

Envoyez une marque ou un sujet et lisez la ventilation sur une seule ligne.

  1. Envoyez {"query": "notion"} en POST à /v1/brand-monitoring/sentiment.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded. Pour une recherche très large, comptez quelques minutes.
  3. Lisez la ventilation dans results.items. has_more et results.next_cursor suivent les règles de pagination habituelles et restent vides pour ce résultat d’une seule ligne.
curl -X POST "https://api.socq.ai/v1/brand-monitoring/sentiment" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"notion"}'

Cas d’usage de la Brand Sentiment Analysis API

  • Instantané mensuel de réputation : Relevez chaque mois le mentions_count de chaque groupe de sentiment et suivez dans le temps la part de pages négatives.
  • Trouver l’origine des critiques : Examinez top_domains, countries et page_types du groupe négatif pour savoir si les critiques se concentrent sur quelques sites, un pays ou des forums.
  • Comparaison avec la concurrence : Analysez votre marque et vos concurrents avec des recherches construites de la même façon, puis comparez le nombre de pages positives, négatives et neutres et les émotions dominantes.
  • Bilan de campagne : Comparez les groupes d’émotion comme la joie ou la colère avant et après une campagne pour voir comment la conversation a évolué.

Conseils d’expert pour la Brand Sentiment Analysis API

  • Analysez des noms de produits ou de campagnes précis plutôt que des mots courants : une recherche large qui compte des millions de mentions peut prendre quelques minutes.
  • Lancez l’analyse des concurrents le même jour que la vôtre pour que tous les instantanés reflètent le même état du web.
  • Quand un groupe varie nettement, appelez Brand Mentions API avec la même query pour lire les pages qui se trouvent derrière.

En complément de la Brand Sentiment Analysis API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Brand Monitoring.

  • Brand Mentions API — Trouvez les pages web qui citent une marque, un produit ou un sujet, avec le passage, l’auteur, la date, le type de site, les scores de sentiment et d’émotion et l’autorité de la page et du domaine.

Explorer d’autres plateformes

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

Brand Sentiment Analysis API — FAQ

Brand Sentiment Analysis API résume la tonalité des pages web qui citent une marque, un produit ou un sujet et renvoie le nombre de pages dans trois groupes de sentiment et six groupes d’émotion, avec les principaux sites, pays, langues et types de pages de chaque groupe.

Brand Mentions API renvoie les pages une par une, chacune avec ses propres scores. Brand Sentiment Analysis API renvoie une seule ligne qui résume l’ensemble des pages correspondantes, regroupées par sentiment et par émotion.

La joie, l’amour, l’amusement, le partage, la tristesse et la colère. Chacune forme un groupe distinct avec son nombre de pages et sa ventilation par provenance.

La plupart des recherches aboutissent en moins d’une minute. Une recherche large qui correspond à des millions de pages peut prendre quelques minutes.

10 crédits par requête, qui renvoie une ligne.