Brand Monitoring API
Trouvez les pages web qui citent une marque, un produit ou un sujet, notez chacune selon le sentiment et l’émotion, et résumez la façon dont le web en parle.
API Brand Monitoring disponibles
Utilisez Brand Mentions API pour des preuves page par page avec scores de sentiment et d’autorité, ou Brand Sentiment Analysis API pour une ligne de synthèse par sentiment et émotion.
Quelles données de veille de marque pouvez-vous récupérer ?
Les deux API s’appuient sur le même ensemble de pages web indexées : l’une renvoie les pages, l’autre les résume.
Mentions sur des pages web
Titre, URL, passage autour de la mention, auteur, domaine, langue, pays et date de publication ou de collecte.
Sentiment et émotions
Parts positive, négative et neutre pour un total de 1, et scores de 0 à 1 pour la joie, l’amour, l’amusement, le partage, la tristesse et la colère.
Autorité et qualité
Rang du domaine et de la page de 0 à 1000, scores de spam et de qualité du contenu de 0 à 100.
Types de sites
Article de presse, blog, forum, page marchande ou site d’organisation pour chaque page.
Répartition du sentiment
Nombre de pages par groupe de sentiment et d’émotion, avec les principaux domaines, pays, langues et types de pages de chaque groupe.
Brand Mentions ou Brand Sentiment Analysis
Lancez les deux avec la même query lorsque vous avez besoin de la vue d’ensemble et des pages qui la composent.
| Critère | Brand Mentions API | Brand Sentiment Analysis API |
|---|---|---|
| Résultat | Une ligne par page web | Une ligne de synthèse par query |
| Sentiment | Scores du passage de chaque page | Nombre de pages par groupe de sentiment et d’émotion |
| Sources | Domaine, auteur, type de site et autorité par page | Principaux domaines, pays, langues et types de pages par groupe |
| Filtres | query, content_type et results_limit jusqu’à 1 000 | query |
| Tarif | 10 crédits par requête plus 0,02 par page | 10 crédits par requête |
Fonctionnement de l’API Brand Monitoring
Les deux API suivent le même flux de tâches asynchrones.
1. Envoyer une query
Envoyez une marque, un produit ou un sujet en POST à /v1/brand-monitoring/mentions ou /v1/brand-monitoring/sentiment.
2. Suivre la tâche
Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded ; une recherche large peut prendre quelques minutes.
3. Lire les résultats
Lisez les pages ou la ligne de synthèse dans results.items.
Authentifiez-vous avec votre clé API SocQ et envoyez un nom de marque. Une requête coûte 10 crédits plus 0,02 crédit par page renvoyée.
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}'
# Poll GET /v1/tasks/{task_id}
# Read the mentions in results.itemsCas d’usage courants de l’API Brand Monitoring
Suivi de l’e-réputation
Repérez les passages négatifs sur les pages à forte autorité et traitez-les en priorité.
Suivi des retombées presse
Rassemblez après un lancement ou une annonce les mentions dans la presse avec auteur, date et rang du domaine.
Comparaison concurrentielle
Comparez sentiment, émotions et répartition des sources entre votre marque et vos concurrents.
Écoute des communautés
Rassemblez les fils de forum où les gens décrivent un produit avec leurs propres mots.
Bilan de campagne
Comparez les groupes de sentiment et d’émotion avant et après une campagne.
Règles de requête et tarifs
Ces règles s’appliquent aux deux API Brand Monitoring.
- query accepte une marque, un produit ou un sujet de 100 caractères au plus ; une expression entre guillemets droits est recherchée à l’identique.
- Brand Mentions API accepte pour content_type news, blogs, message-boards, ecommerce ou organization, et renvoie de 1 à 1 000 pages, 100 par défaut.
- La plupart des synthèses de sentiment aboutissent en moins d’une minute ; une recherche large qui correspond à des millions de pages peut prendre quelques minutes.
- Brand Mentions API coûte 10 crédits par requête plus 0,02 crédit par page renvoyée ; Brand Sentiment Analysis API coûte 10 crédits par requête.
Questions fréquentes sur l’API Brand Monitoring
Qu’est-ce que Brand Monitoring API ?
Brand Monitoring API trouve les pages web qui citent une marque, un produit ou un sujet et mesure leur sentiment, page par page avec Brand Mentions API ou sous forme de synthèse avec Brand Sentiment Analysis API.
Quelles API Brand Monitoring sont disponibles ?
Brand Mentions API pour les pages une à une avec scores de sentiment, d’émotion et d’autorité, et Brand Sentiment Analysis API pour la répartition du sentiment et des émotions de toutes les pages correspondantes.
Quels sites sont couverts ?
Les pages web publiques indexées : articles de presse, blogs, forums, pages marchandes, sites d’organisations, etc.
Comment le sentiment est-il mesuré ?
Le passage autour de chaque mention est évalué comme positif, négatif ou neutre et pour six émotions ; la synthèse regroupe ensuite les pages selon ces scores.
Comment les requêtes Brand Monitoring sont-elles facturées ?
Brand Mentions API coûte 10 crédits par requête plus 0,02 crédit par page renvoyée. Brand Sentiment Analysis API coûte 10 crédits par requête.
Combinez les données de plusieurs plateformes pour des analyses métier plus complètes
Réunissez dans un même workflow les profils publics, les contenus et les données d’engagement de différentes plateformes pour suivre des marques, des créateurs et des sujets, et mener plus efficacement une veille et des analyses multiplateformes.
AI Search API
Suivez comment AI Overviews, ChatGPT et Google AI Mode répondent aux questions de votre marché : les réponses qui citent votre marque, votre niveau de visibilité, et les domaines et pages qu’ils citent.
Instagram API
Recherchez ou trouvez des profils publics et collectez enregistrements de listes d’abonnés, relations d’abonnement, publications publiées, publications où un profil est identifié, résultats par hashtag, Reels, transcriptions, commentaires, nombres de comptes, indicateurs d’engagement et métadonnées de médias dans un seul workflow asynchrone.
TikTok API
Collectez des profils TikTok publics pris en charge, les métadonnées de vidéos directes, les commentaires de premier niveau, des résultats de recherche de vidéos et les vidéos de hashtags précis dans un seul flux asynchrone normalisé.
YouTube API
Collectez les profils de chaînes YouTube publics pris en charge, les détails de vidéos, les vidéos de chaînes, les commentaires, les Shorts, les résultats par mot-clé et par hashtag, ainsi que les transcriptions disponibles, dans un seul flux asynchrone normalisé.
Facebook API
Collectez des profils de Pages Facebook publiques, des publications, des publications de groupes, des commentaires, des événements correspondant à un mot-clé et les transcriptions vidéo disponibles, avec des champs normalisés d’identité, de contenu, de source, de format, de lieu, de médias, de réactions, de participation et d’engagement.
X API
Collectez des profils publics, les relations d’abonnés et d’abonnements, des posts, des réponses, des citations, les comptes qui ont reposté, des résultats de recherche et les tendances actuelles. Des résultats homogènes pour vos recherches et votre veille.

