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/mentionspour obtenir la liste des pages web qui le mentionnent, chacune avec des scores de sentiment, d’émotion et d’autorité. Envoyez la mêmequeryàPOST /v1/brand-monitoring/sentimentpour obtenir une seule ligne qui répartit toutes les mentions par sentiment et par émotion. InterrogezGET /v1/tasks/{task_id}pour récupérer les résultats.
Les nouveaux endpoints Brand Monitoring
1 crédit SocQ = $0,005.
| Endpoint | Ce qu’il renvoie | Prix |
|---|---|---|
| Brand Mentions API | Une 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 domaine | 10 crédits ($0,05) par requête + 0,02 crédit ($0,0001) par page |
| Brand Sentiment Analysis API | Une 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 groupe | 10 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 ;WWsignifie le monde entier) etpage_types, commenews,blogsouecommerce. - Quoi :
text, le passage autour de la mention, etauthor_namelorsqu’il est fourni. - Quel ressenti :
sentiment, avec des scorespositive,negativeetneutralde 0 à 1 dont la somme vaut 1, etemotions, avec six scores de 0 à 1 :happiness,love,fun,share,sadnessetanger. - 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_ranketpage_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 depositive,negativeetneutral.emotions: un groupe pour chacune dehappiness,love,fun,share,sadnessetanger.
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_typedéfini surnewsoumessage-boards, puis triez par sentimentnegativeet pardomain_rank. - Analyser un pic : lorsque les nombres de sentiments évoluent, utilisez les
top_domainsdu 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