Brand MonitoringMentions de marqueAnalyse de sentimentE-réputationGuide API

API Brand Monitoring : mentions web avec scores de sentiment, d’émotion et d’autorité

Deux nouveaux endpoints SocQ collectent les pages web qui mentionnent une marque avec des scores de sentiment, d’émotion et d’autorité, et répartissent toutes les mentions entre positives, négatives et neutres.

SocQMis à jour le 19 novembre 20268 min de lecture

La veille de marque commence généralement par deux questions : où parle-t-on de nous sur le web, et qu’en pense-t-on ? La première exige des données page par page que vous pouvez lire et transmettre aux bonnes personnes. La seconde exige un agrégat que vous pouvez représenter en graphique sans télécharger des millions de pages.

Le 2026-11-17, SocQ a lancé la plateforme Brand Monitoring avec un endpoint pour chacune de ces questions. Ce guide présente ce qu’ils renvoient, les requêtes, le prix et le moment où utiliser chacun d’eux.

Réponse rapide : envoyez une marque, un produit ou un sujet dans query à POST /v1/brand-monitoring/mentions pour obtenir la liste des pages web qui le mentionnent, chacune avec des scores de sentiment, d’émotion et d’autorité. Envoyez la même query à POST /v1/brand-monitoring/sentiment pour obtenir une seule ligne qui répartit toutes les mentions par sentiment et par émotion. Interrogez GET /v1/tasks/{task_id} pour récupérer les résultats.

Les nouveaux endpoints Brand Monitoring

1 crédit SocQ = $0,005.

EndpointCe qu’il renvoiePrix
Brand Mentions APIUne ligne par page web qui mentionne la requête : URL, titre, passage autour de la mention, auteur, langue, pays, type de site, scores de sentiment et d’émotion, et autorité de la page et du domaine10 crédits ($0,05) par requête + 0,02 crédit ($0,0001) par page
Brand Sentiment Analysis APIUne ligne qui regroupe toutes les pages mentionnant la requête par sentiment principal et par émotion dominante, avec le nombre de pages et les principaux sites, pays, langues et types de sites de chaque groupe10 crédits ($0,05) par appel

Pour Brand Mentions, la base de 10 crédits s’applique aussi lorsqu’aucune page n’est trouvée.

Authentification et flux de tâches asynchrones

Toutes les requêtes SocQ s’authentifient avec une clé API, et le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque collecte s’exécute comme une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La réponse à l’envoi contient data.task_id et data.status. Interrogez la tâche avec cet ID :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque status vaut succeeded, la réponse contient la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500 ; si has_more est vrai, passez results.next_cursor comme cursor pour lire la page suivante. Tant qu’une tâche est queued, running ou failed, l’endpoint renvoie les métadonnées de la tâche sans results.

Un callback_url facultatif dans le corps de l’envoi permet à SocQ d’envoyer un POST contenant un résumé de la tâche lorsqu’elle se termine ; lisez ensuite les enregistrements avec GET /v1/tasks/{task_id}. Un délai d’expiration côté client n’annule pas une tâche : reprenez avec le même ID de tâche plutôt que de payer un doublon. 402 signifie que les crédits sont insuffisants ; 429 signifie que la clé a atteint une limite de débit ou de crédits.

Brand Mentions API : toutes les pages qui vous mentionnent

La Brand Mentions API renvoie des pages de tout le web qui mentionnent votre requête : avis sur des blogs, articles de presse, fils de forums et fiches produits. Indiquez une marque, un produit ou un sujet dans query, jusqu’à 100 caractères. Mettez une expression entre guillemets doubles pour la rechercher à l’identique. content_type limite les résultats aux sites news, blogs, message-boards, ecommerce ou organization. results_limit vaut 100 par défaut et accepte de 1 à  .

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
  }'

Chaque ligne décrit une page :

  • Où : url, title, domain, language, country (deux lettres ; WW signifie le monde entier) et page_types, comme news, blogs ou ecommerce.
  • Quoi : text, le passage autour de la mention, et author_name lorsqu’il est fourni.
  • Quel ressenti : sentiment, avec des scores positive, negative et neutral de 0 à 1 dont la somme vaut 1, et emotions, avec six scores de 0 à 1 : happiness, love, fun, share, sadness et anger.
  • Quel poids : content_quality_score (0 à 100), spam_score (0 à 100 ; plus il est élevé, plus la page présente de signes de spam), domain_rank et page_rank (0 à  ).
  • Quand : fetched_at, le moment où la page a été lue pour la dernière fois.

Les scores d’autorité et de spam vous permettent de trier un grand ensemble de résultats afin que l’équipe lise d’abord les pages à forte autorité et faible spam, tandis que la répartition des sentiments signale les pages qui appellent une réponse. 100 pages coûtent 12 crédits ($0,06), et le maximum de   pages coûte 30 crédits ($0,15). Liste complète des champs : documentation Brand Mentions.

Pour ne surveiller que la presse, ajoutez un filtre :

{
  "query": "\"notion ai\"",
  "content_type": "news",
  "results_limit": 200
}

Brand Sentiment Analysis API : le détail derrière le chiffre

La Brand Sentiment Analysis API répond à la question « qu’en pense le web ? » sans renvoyer de pages individuelles. Les pages qui mentionnent votre requête sont regroupées par sentiment principal et, séparément, par émotion dominante. Chaque groupe indique combien de pages il contient ainsi que les sites, pays, langues et types de sites qui y contribuent le plus.

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"
  }'

L’unique ligne de résultat contient deux tableaux :

  • sentiments : un groupe pour chacun de positive, negative et neutral.
  • emotions : un groupe pour chacune de happiness, love, fun, share, sadness et anger.

Chaque groupe possède un label, un mentions_count ainsi que top_domains, countries, languages et page_types, chacun étant une liste de name et count, du plus grand au plus petit. Cette structure vous permet de savoir si les critiques viennent de médias d’information ou d’un seul forum, et quels pays en sont à l’origine. Chaque requête coûte 10 crédits ($0,05). Les termes très larges, avec des millions de mentions, prennent plus de temps à analyser, jusqu’à quelques minutes : interrogez la tâche avec patience. Consultez la documentation Brand Sentiment Analysis.

Quel endpoint utiliser

  • Un tableau de bord hebdomadaire d’e-réputation : lancez Brand Sentiment Analysis pour votre marque et pour chaque concurrent, stockez les nombres et suivez-les dans le temps. Quatre marques coûtent 40 crédits ($0,20) par exécution.
  • Une file de tri pour l’équipe communication : lancez Brand Mentions avec content_type défini sur news ou message-boards, puis triez par sentiment negative et par domain_rank.
  • Analyser un pic : lorsque les nombres de sentiments évoluent, utilisez les top_domains du groupe négatif pour voir quels sites en sont à l’origine, puis récupérez ces pages avec Brand Mentions.

Les deux endpoints portent sur des pages web relevant des cinq types de sites ci-dessus. Pour les publications et commentaires sur les réseaux sociaux, utilisez les endpoints par plateforme décrits dans le guide de l’API unifiée pour les réseaux sociaux. Pour savoir ce que disent les assistants IA de votre marque, consultez le guide de l’API AI Search.

FAQ

Qu’est-ce qu’une API de veille de marque ?

Une API qui identifie où une marque, un produit ou un sujet est mentionné et quel ressenti expriment ces mentions. La version de SocQ renvoie des mentions page par page avec des scores de sentiment, d’émotion et d’autorité, ainsi qu’une répartition agrégée par sentiment et par émotion.

Comment rechercher une expression exacte ?

Mettez-la entre guillemets doubles dans query, par exemple "\"notion ai\"" en JSON. La requête peut contenir jusqu’à 100 caractères.

Quels types de sites sont couverts ?

Les pages sont classées en news, blogs, message-boards, ecommerce ou organization. Brand Mentions peut être limité à l’un de ces types avec content_type.

Suis-je facturé lorsque rien n’est trouvé ?

Brand Mentions facture sa base de 10 crédits même lorsqu’aucune page n’est trouvée, plus 0,02 crédit par page renvoyée. Brand Sentiment Analysis coûte 10 crédits par requête.

Pourquoi ma tâche de sentiment est-elle toujours en cours ?

Les termes très larges, avec des millions de mentions, prennent plus de temps à analyser, jusqu’à quelques minutes. Continuez d’interroger le même task_id ; ne renvoyez pas la requête.

BRAND MONITORING API

Tester le workflow avec une URL publique Brand Monitoring

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API Brand Monitoring