Retour aux API
Données de veille de marque

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èreBrand Mentions APIBrand Sentiment Analysis API
RésultatUne ligne par page webUne ligne de synthèse par query
SentimentScores du passage de chaque pageNombre de pages par groupe de sentiment et d’émotion
SourcesDomaine, auteur, type de site et autorité par pagePrincipaux domaines, pays, langues et types de pages par groupe
Filtresquery, content_type et results_limit jusqu’à 1 000query
Tarif10 crédits par requête plus 0,02 par page10 crédits par requête

Fonctionnement de l’API Brand Monitoring

Les deux API suivent le même flux de tâches asynchrones.

  1. 1. Envoyer une query

    Envoyez une marque, un produit ou un sujet en POST à /v1/brand-monitoring/mentions ou /v1/brand-monitoring/sentiment.

  2. 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. 3. Lire les résultats

    Lisez les pages ou la ligne de synthèse dans results.items.

Trouver les mentions d’une marque sur le web

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.items

Cas 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.

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.