Zurück zu den APIs
Brand-Monitoring-Daten

Brand Monitoring API

Finden Sie Webseiten, die eine Marke, ein Produkt oder ein Thema erwähnen, bewerten Sie jede nach Sentiment und Emotion und fassen Sie zusammen, wie das Web darüber spricht.

Verfügbare Brand-Monitoring-APIs

Nutzen Sie die Brand Mentions API für Belege Seite für Seite mit Sentiment- und Autoritätswerten oder die Brand Sentiment Analysis API für eine Übersichtszeile nach Sentiment und Emotion.

Welche Brand-Monitoring-Daten können Sie abrufen?

Beide APIs greifen auf denselben Bestand indexierter Webseiten zu: Die eine liefert die Seiten, die andere fasst sie zusammen.

Erwähnungen auf Webseiten

Seitentitel, URL, Passage rund um die Erwähnung, Autor, Domain, Sprache, Land und Veröffentlichungs- oder Abrufdatum.

Sentiment und Emotionen

Anteile positiv, negativ und neutral mit der Summe 1 sowie Werte von 0 bis 1 für Freude, Liebe, Spaß, Teilen, Traurigkeit und Wut.

Autorität und Qualität

Domain- und Seitenrang von 0 bis 1000 sowie Spam- und Inhaltsqualitätswerte von 0 bis 100.

Seitentypen

Ob eine Seite ein Nachrichtenartikel, ein Blog, ein Forum, eine Shopseite oder eine Organisationswebsite ist.

Sentiment-Aufschlüsselung

Seitenzahl je Sentiment- und Emotionsgruppe mit den wichtigsten Domains, Ländern, Sprachen und Seitentypen dahinter.

Brand Mentions oder Brand Sentiment Analysis

Führen Sie beide mit derselben query aus, wenn Sie das Gesamtbild und die Seiten dahinter brauchen.

VergleichBrand Mentions APIBrand Sentiment Analysis API
ErgebnisEine Zeile pro WebseiteEine Übersichtszeile pro query
SentimentWerte für die Passage jeder SeiteSeitenzahl je Sentiment- und Emotionsgruppe
QuellenDomain, Autor, Seitentyp und Autorität je SeiteWichtigste Domains, Länder, Sprachen und Seitentypen je Gruppe
Filterquery, content_type und results_limit bis 1.000query
Preis10 Credits pro Anfrage plus 0,02 pro Seite10 Credits pro Anfrage

So funktioniert die Brand Monitoring API

Beide APIs nutzen denselben asynchronen Ablauf.

  1. 1. query senden

    Senden Sie eine Marke, ein Produkt oder ein Thema per POST an /v1/brand-monitoring/mentions oder /v1/brand-monitoring/sentiment.

  2. 2. Aufgabe verfolgen

    Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat; breite Begriffe können einige Minuten dauern.

  3. 3. Ergebnisse lesen

    Lesen Sie die Seiten oder die Übersichtszeile in results.items.

Erwähnungen einer Marke im Web finden

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie einen Markennamen. Eine Anfrage kostet 10 Credits plus 0,02 Credits pro zurückgegebener Seite.

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

Typische Anwendungsfälle der Brand Monitoring API

Reputationsmonitoring

Markieren Sie negative Passagen auf Seiten mit hoher Autorität und prüfen Sie diese zuerst.

Presseresonanz verfolgen

Sammeln Sie nach einem Launch oder einer Ankündigung Nachrichtenerwähnungen mit Autor, Datum und Domainrang.

Wettbewerbs-Benchmarks

Vergleichen Sie Sentiment, Emotionen und Quellenmix Ihrer Marke mit denen von Wettbewerbern.

Stimmen aus Communitys

Sammeln Sie Forenthreads, in denen Menschen ein Produkt mit eigenen Worten beschreiben.

Kampagnen auswerten

Vergleichen Sie Sentiment- und Emotionsgruppen vor und nach einer Kampagne.

Anfrageregeln und Preise

Diese Regeln gelten für beide Brand-Monitoring-APIs.

  • query nimmt Marke, Produkt oder Thema mit bis zu 100 Zeichen auf; Phrasen in doppelten Anführungszeichen werden exakt gesucht.
  • Die Brand Mentions API akzeptiert als content_type news, blogs, message-boards, ecommerce oder organization und liefert 1–1.000 Seiten, standardmäßig 100.
  • Die meisten Sentiment-Übersichten sind in unter einer Minute fertig; breite Begriffe mit Millionen passender Seiten können einige Minuten dauern.
  • Die Brand Mentions API kostet 10 Credits pro Anfrage plus 0,02 Credits pro zurückgegebener Seite, die Brand Sentiment Analysis API 10 Credits pro Anfrage.

Häufige Fragen zur Brand Monitoring API

Was ist die Brand Monitoring API?

Die Brand Monitoring API findet Webseiten, die eine Marke, ein Produkt oder ein Thema erwähnen, und misst ihr Sentiment – Seite für Seite mit der Brand Mentions API oder als eine Übersicht mit der Brand Sentiment Analysis API.

Welche Brand-Monitoring-APIs sind verfügbar?

Die Brand Mentions API für einzelne Seiten mit Sentiment-, Emotions- und Autoritätswerten und die Brand Sentiment Analysis API für die Sentiment- und Emotionsverteilung aller passenden Seiten.

Welche Websites werden abgedeckt?

Indexierte öffentliche Webseiten wie Nachrichtenartikel, Blogs, Foren, Shopseiten und Organisationswebsites.

Wie wird das Sentiment gemessen?

Die Passage rund um jede Erwähnung wird als positiv, negativ oder neutral sowie für sechs Emotionen bewertet; die Sentiment-Übersicht gruppiert die Seiten nach diesen Werten.

Wie werden Brand-Monitoring-Anfragen berechnet?

Die Brand Mentions API kostet 10 Credits pro Anfrage plus 0,02 Credits pro zurückgegebener Seite. Die Brand Sentiment Analysis API kostet 10 Credits pro Anfrage.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.

AI Search API

Verfolgen Sie, wie AI Overviews, ChatGPT und Google AI Mode die Fragen in Ihrem Markt beantworten: welche Antworten Ihre Marke nennen, wie sichtbar Sie sind und welche Domains und Seiten zitiert werden.

Instagram API

Rufen Sie öffentliche Profile ab oder finden Sie sie, und erfassen Sie in einem einzigen asynchronen Ablauf Follower-Listen, Gefolgten-Beziehungen, eigene Beiträge, in Profilen markierte Beiträge, Hashtag-Ergebnisse, Reels, Transkripte, Kommentare, Kontozahlen, Engagement-Kennzahlen und Medienmetadaten.

TikTok API

Erfassen Sie unterstützte öffentliche TikTok-Profile, Metadaten einzelner Videos, Kommentare der obersten Ebene, Videosuchergebnisse und Videos zu bestimmten Hashtags in einem einheitlichen, normalisierten asynchronen Ablauf.

YouTube API

Erfassen Sie unterstützte öffentliche YouTube-Kanalprofile, Videodetails, Kanalvideos, Kommentare, Shorts, Stichwort- und Hashtag-Ergebnisse sowie verfügbare Transkripte in einem einheitlichen, normalisierten asynchronen Ablauf.

Facebook API

Erfassen Sie öffentliche Facebook-Seitenprofile, Beiträge, Gruppenbeiträge, Kommentare, per Stichwort gefundene Events und verfügbare Videotranskripte – mit normalisierten Feldern zu Identität, Inhalt, Quelle, Format, Ort, Medien, Reaktionen, Teilnahme und Engagement.

X API

Erfassen Sie öffentliche Profile, Follower- und Gefolgten-Beziehungen, Posts, Antworten, Zitat-Posts, Reposter, Suchergebnisse und aktuelle Trends. Nutzen Sie einheitliche Ergebnisse für Recherche und Monitoring.