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ètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Marque, 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.
- Envoyez {"query": "notion"} en POST à /v1/brand-monitoring/sentiment.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded. Pour une recherche très large, comptez quelques minutes.
- 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.
API associées
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.