Markenbeobachtung beginnt meist mit zwei Fragen: Wo spricht das Web über uns, und wie denkt es über uns? Die erste braucht Daten auf Seitenebene, die Sie lesen und weiterleiten können. Die zweite braucht eine Aggregation, die Sie als Diagramm darstellen können, ohne Millionen Seiten herunterzuladen.
Am 2026-11-17 hat SocQ die Brand-Monitoring-Plattform mit je einem Endpunkt pro Frage gestartet. Dieser Leitfaden zeigt, was sie liefern, wie die Anfragen aussehen, was sie kosten und wann sich welcher eignet.
Kurze Antwort: Senden Sie eine Marke, ein Produkt oder ein Thema in
queryanPOST /v1/brand-monitoring/mentions, um eine Liste von Webseiten zu erhalten, die es erwähnen, jeweils mit Sentiment-, Emotions- und Autoritätswerten. Senden Sie dieselbequeryanPOST /v1/brand-monitoring/sentiment, um eine Zeile zu erhalten, die alle Erwähnungen nach Sentiment und Emotion aufteilt. Fragen Sie die Ergebnisse überGET /v1/tasks/{task_id}ab.
Die neuen Brand-Monitoring-Endpunkte
1 SocQ-Credit = $0,005.
| Endpunkt | Was er liefert | Preis |
|---|---|---|
| Brand Mentions API | Eine Zeile pro Webseite, die die Suchanfrage erwähnt: URL, Titel, die Textpassage um die Erwähnung, Autor, Sprache, Land, Website-Typ, Sentiment- und Emotionswerte sowie Seiten- und Domain-Autorität | 10 Credits ($0,05) pro Anfrage + 0,02 Credits ($0,0001) pro Seite |
| Brand Sentiment Analysis API | Eine Zeile, die alle Seiten mit der Suchanfrage nach Hauptsentiment und stärkster Emotion gruppiert, mit Seitenzahlen und den führenden Websites, Ländern, Sprachen und Website-Typen je Gruppe | 10 Credits ($0,05) pro Aufruf |
Bei Brand Mentions fällt die Grundgebühr von 10 Credits auch dann an, wenn keine Seite gefunden wird.
Authentifizierung und asynchroner Aufgabenablauf
Alle SocQ-Anfragen authentifizieren sich mit einem API-Schlüssel, und derselbe Header gilt für das Einreichen, den Aufgabenstatus und den Abruf der Ergebnisse:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Jede Erfassung läuft als Hintergrundaufgabe:
submit -> task_id -> queued -> running -> succeeded
\-> failed
Die Antwort auf das Einreichen enthält data.task_id und data.status. Fragen Sie die Aufgabe mit dieser ID ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Wenn status den Wert succeeded hat, enthält die Antwort die erste Seite normalisierter Datensätze in data.results.items. limit ist standardmäßig 50 und geht bis 500; ist has_more true, übergeben Sie results.next_cursor als cursor, um die nächste Seite zu lesen. Solange eine Aufgabe queued, running oder failed ist, liefert der Endpunkt Aufgabenmetadaten ohne results.
Mit einer optionalen callback_url im Anfragekörper sendet SocQ nach Abschluss der Aufgabe einen POST mit einer Aufgabenzusammenfassung; die Datensätze lesen Sie über GET /v1/tasks/{task_id}. Eine Zeitüberschreitung auf Client-Seite bricht die Aufgabe nicht ab. Setzen Sie deshalb mit derselben Aufgaben-ID fort, statt für ein Duplikat zu bezahlen. 402 bedeutet zu wenige Credits; 429 bedeutet, dass der Schlüssel ein Raten- oder Credit-Limit erreicht hat.
Brand Mentions API: jede Seite, die Sie erwähnt
Die Brand Mentions API liefert Seiten aus dem gesamten Web, die Ihre Suchanfrage erwähnen: Blog-Rezensionen, Nachrichtenberichte, Forenthreads und Produktangebote. Geben Sie in query eine Marke, ein Produkt oder ein Thema mit bis zu 100 Zeichen an. Setzen Sie eine Wortgruppe in doppelte Anführungszeichen, um sie exakt zu treffen. content_type beschränkt die Ergebnisse auf Websites vom Typ news, blogs, message-boards, ecommerce oder organization. results_limit ist standardmäßig 100 und akzeptiert 1 bis 1.000.
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
}'
Jede Zeile beschreibt eine Seite:
- Wo:
url,title,domain,language,country(zwei Buchstaben;WWsteht für weltweit) undpage_types, etwanews,blogsoderecommerce. - Was:
text, die Textpassage um die Erwähnung, undauthor_name, sofern angegeben. - Wie die Stimmung ist:
sentimentmit den Wertenpositive,negativeundneutralvon 0 bis 1, die zusammen 1 ergeben, undemotionsmit sechs Werten von 0 bis 1:happiness,love,fun,share,sadnessundanger. - Wie viel Gewicht sie hat:
content_quality_score(0 bis 100),spam_score(0 bis 100, höher bedeutet mehr Spam-Anzeichen),domain_rankundpage_rank(0 bis 1.000). - Wann:
fetched_at, der Zeitpunkt, zu dem die Seite zuletzt gelesen wurde.
Mit den Autoritäts- und Spam-Werten sortieren Sie eine große Ergebnismenge so, dass das Team zuerst Seiten mit hoher Autorität und wenig Spam liest, während die Sentiment-Aufteilung Seiten markiert, die eine Antwort brauchen. 100 Seiten kosten 12 Credits ($0,06), das Maximum von 1.000 Seiten kostet 30 Credits ($0,15). Vollständige Feldliste: Brand-Mentions-Dokumentation.
Um nur die Presse zu beobachten, fügen Sie einen Filter hinzu:
{
"query": "\"notion ai\"",
"content_type": "news",
"results_limit": 200
}
Brand Sentiment Analysis API: die Aufschlüsselung hinter der Zahl
Die Brand Sentiment Analysis API beantwortet die Frage „Wie denkt das Web über uns?“, ohne einzelne Seiten zurückzugeben. Seiten, die Ihre Suchanfrage erwähnen, werden nach ihrem Hauptsentiment und getrennt davon nach ihrer stärksten Emotion gruppiert. Jede Gruppe meldet, wie viele Seiten sie enthält und welche Websites, Länder, Sprachen und Website-Typen am meisten beitragen.
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"
}'
Die einzelne Ergebniszeile enthält zwei Arrays:
sentiments: je eine Gruppe fürpositive,negativeundneutral.emotions: je eine Gruppe fürhappiness,love,fun,share,sadnessundanger.
Jede Gruppe hat ein label, einen mentions_count sowie top_domains, countries, languages und page_types, jeweils eine Liste aus name und count, die größten zuerst. An dieser Struktur erkennen Sie, ob Kritik von Nachrichtenportalen oder aus einem einzelnen Forum kommt und welche Länder sie treiben. Jede Anfrage kostet 10 Credits ($0,05). Sehr breite Begriffe mit Millionen Erwähnungen brauchen länger für die Analyse, bis zu einigen Minuten; fragen Sie also geduldig ab. Siehe die Brand-Sentiment-Analysis-Dokumentation.
Welchen Endpunkt Sie nutzen sollten
- Ein wöchentliches Reputations-Dashboard: Führen Sie Brand Sentiment Analysis für Ihre Marke und jeden Wettbewerber aus, speichern Sie die Zahlen und stellen Sie sie im Zeitverlauf dar. Vier Marken kosten 40 Credits ($0,20) pro Lauf.
- Eine Triage-Warteschlange für das Kommunikationsteam: Führen Sie Brand Mentions mit
content_typeaufnewsodermessage-boardsaus und sortieren Sie dann nachnegative-Sentiment unddomain_rank. - Einen Ausschlag untersuchen: Wenn sich die Sentiment-Zahlen bewegen, sehen Sie an den
top_domainsder negativen Gruppe, welche Websites ihn treiben, und holen Sie diese Seiten dann mit Brand Mentions.
Beide Endpunkte arbeiten mit Webseiten der fünf oben genannten Website-Typen. Für Beiträge und Kommentare in sozialen Netzwerken nutzen Sie die Plattform-Endpunkte aus dem Leitfaden zur einheitlichen Social-Media-API. Was KI-Assistenten über Ihre Marke sagen, zeigt der Leitfaden zur AI Search API.
FAQ
Was ist eine Brand Monitoring API?
Eine API, die findet, wo eine Marke, ein Produkt oder ein Thema erwähnt wird und wie diese Erwähnungen gestimmt sind. Die Version von SocQ liefert Erwähnungen auf Seitenebene mit Sentiment-, Emotions- und Autoritätswerten sowie eine aggregierte Aufschlüsselung nach Sentiment und Emotion.
Wie treffe ich eine exakte Wortgruppe?
Setzen Sie sie innerhalb von query in doppelte Anführungszeichen, in JSON zum Beispiel "\"notion ai\"". Die Suchanfrage darf bis zu 100 Zeichen lang sein.
Welche Arten von Websites sind abgedeckt?
Seiten werden als news, blogs, message-boards, ecommerce oder organization klassifiziert. Brand Mentions lässt sich mit content_type auf einen dieser Typen beschränken.
Wird mir etwas berechnet, wenn nichts gefunden wird?
Brand Mentions berechnet die Grundgebühr von 10 Credits auch dann, wenn keine Seite gefunden wird, plus 0,02 Credits pro gelieferter Seite. Brand Sentiment Analysis kostet 10 Credits pro Anfrage.
Warum läuft meine Sentiment-Aufgabe noch?
Sehr breite Begriffe mit Millionen Erwähnungen brauchen länger für die Analyse, bis zu einigen Minuten. Fragen Sie weiter dieselbe task_id ab und reichen Sie die Anfrage nicht erneut ein.
BRAND MONITORING API
Workflow mit einer öffentlichen Brand Monitoring-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
Brand Monitoring-APIs ansehen