Brand Mentions
Eine Markenerwähnung ist eine öffentliche Webseite, in deren Text der Markenname vorkommt, etwa ein Testbericht, ein Nachrichtenartikel, ein Forenthread oder eine Produktseite, zusammen mit der Passage rund um den Namen, Autor, Sprache, Land und Veröffentlichungsdatum. Mit Sentiment bewertet und nach Seiten- und Domainautorität geordnet zeigen diese Seiten, wo über eine Marke gesprochen wird, in welche Richtung die Diskussion geht und welche Quellen Gewicht haben – die Grundlage für Reputationsmonitoring, PR-Erfolgsmessung und Wettbewerbsanalyse.
Funktionen der Brand Mentions API
- Stichwortsuche und exakte Trefferquery nimmt Marke, Produkt oder Thema mit bis zu 100 Zeichen auf; in doppelte Anführungszeichen gesetzte Phrasen werden genau so gesucht.
- Filter nach Seitentypcontent_type beschränkt die Ergebnisse auf news, blogs, message-boards, ecommerce oder organization, und page_types nennt den Typ jedes Treffers.
- Sentiment je Passagesentiment teilt die Passage in positiv, negativ und neutral mit der Summe 1 auf, und emotions bewertet Freude, Liebe, Spaß, Teilen, Traurigkeit und Wut jeweils von 0 bis 1.
- Autorität und Qualitätdomain_rank und page_rank geben die Autorität von 0 bis 1000 an, spam_score und content_quality_score helfen, dünne oder spamartige Seiten auszusortieren.
- Kontext jeder Erwähnungtitle, die Passage in text, author_name, language, country, published_at (falls angegeben) und fetched_at zeigen, wann und wo die Erwähnung entstand.
- Bis zu 1.000 Seiten pro Abfrageresults_limit reicht von 1 bis 1000, sodass Sie die Webpräsenz einer Marke in einem Durchgang erfassen können.
Parameter der Brand Mentions API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Gesuchte Marke, gesuchtes Produkt oder Thema (bis zu 100 Zeichen). Phrasen in doppelten Anführungszeichen werden exakt gesucht. |
content_type | Optional | Seitentyp, aus dem die Erwähnungen stammen: news, blogs, message-boards, ecommerce oder organization. |
results_limit | Optional | Anzahl der zurückgegebenen Seiten (1–1000). Standardwert ist 100. |
So verwenden Sie die Brand Mentions API
Senden Sie einen Marken- oder Produktnamen und lesen Sie die Erwähnungen Zeile für Zeile.
- Senden Sie {"query": "notion", "results_limit": 100} per POST an /v1/brand-monitoring/mentions.
- Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
- Lesen Sie die Seiten aus results.items und rufen Sie mit results.next_cursor die nächste Seite ab, solange has_more true ist.
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}'Anwendungsfälle der Brand Mentions API
- Reputationsmonitoring: Markieren Sie Passagen, in denen sentiment.negative den positiven Wert übersteigt, und priorisieren Sie sie für die Prüfung nach dem domain_rank der Seite.
- Presseresonanz verfolgen: Setzen Sie content_type auf news und erfassen Sie author_name, published_at und domain_rank, um zu sehen, welche Medien eine Produkteinführung mit welcher Reichweite aufgegriffen haben.
- Marken vergleichen: Führen Sie dieselbe Anfrage für Ihre Marke und einen Wettbewerber aus und vergleichen Sie Seitentypen, Länder und Sentiment-Verteilung der Erwähnungen.
- Stimmen aus Communitys sammeln: Beschränken Sie content_type auf message-boards und sammeln Sie Threads, in denen Nutzer ein Produkt mit eigenen Worten beschreiben.
Profi-Tipps zur Brand Mentions API
- Setzen Sie mehrteilige Markennamen in doppelte Anführungszeichen, etwa "notion ai", um die exakte Wortfolge zu treffen.
- Nutzen Sie für die Aktualität vorrangig published_at und andernfalls fetched_at; viele Seiten nennen kein Veröffentlichungsdatum.
- Entfernen Sie vor der Auswertung Zeilen mit hohem spam_score oder niedrigem content_quality_score, damit dünne Seiten das Sentiment nicht verzerren.
- Kombinieren Sie die Abfrage mit der Brand Sentiment Analysis API, wenn Sie sowohl Belege pro Seite als auch Gesamtanteile brauchen.
Verwandte APIs
Ergänzend zur Brand Mentions API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Brand Monitoring-Daten benötigen.
- Brand Sentiment Analysis API — Fassen Sie in einer Zeile zusammen, wie das Web über eine Marke oder ein Thema spricht, mit Seitenzahl je Sentiment und Emotion sowie den wichtigsten Domains, Ländern und Sprachen je Gruppe.