Dokumentation der API

Beobachtung sozialer Medien

Die Beobachtung sozialer Medien ist ausgeschaltet. Noch ist keine Quelle für soziale Medien eingeschaltet, deshalb antworten die Routen unten mit source.enabled false und ohne Lesung und Beitrag, und das Dashboard zeigt keinen Bereich für soziale Medien. Diese Seite beschreibt, wie sie arbeitet, sobald eine lizenzierte Quelle eingeschaltet ist.

Sie wird Arbeitsbereich für Arbeitsbereich eingeschaltet. Für einen Arbeitsbereich, für den sie eingeschaltet ist, liest Stonewake, was auf sozialen Plattformen und in Foren über jedes Unternehmen gesagt wird, das der Arbeitsbereich im Bestand hält oder beobachtet, und über jede natürliche Person, die er beobachtet, und hält für jedes Unternehmen und jede Person eine tägliche Lesung mit den Beiträgen, auf denen sie beruht. Die Lesungen stehen über die API und für Assistenten mit KI über MCP bereit.

Woher die Beiträge kommen

Die Beiträge kommen von einem Dienst für Social Listening, der seine Ergebnisse lizenziert, nie aus dem Auslesen einer Plattform. Gebaut ist sie zuerst für Awario. Awario sammelt Nennungen eines Unternehmensnamens im Web, in Foren, auf Reddit, YouTube und Vimeo und in enger Form auf öffentlichen Seiten auf Facebook und in Beiträgen auf Instagram von Unternehmenskonten. X wird nicht gelesen. Eine Quelle wird erst eingeschaltet, wenn ihre Lizenz für diese Nutzung schriftlich vorliegt. Jede Antwort nennt in ihrem Feld source, ob eine Quelle eingeschaltet ist, und die Quellenangabe, die mit ihren Daten zu zeigen ist.

Wie ein Beitrag einem Unternehmen zugeordnet wird

Ein Beitrag zählt für ein Unternehmen nur, wenn sein eigener Text das Unternehmen nennt, verglichen genau so, wie die Nachrichtenbeobachtung Namen vergleicht. Ein ganzer Name muss übereinstimmen, BP stimmt also nie mit bpost überein, eine Rechtsform wird ausgeschrieben verglichen, Großschreibung und Kleinschreibung, Satzzeichen und Akzente zählen nicht, und die Markennamen und Kurznamen, die die Aliasliste für den LEI des Unternehmens nennt, zählen nur für dieses Unternehmen. Ein Name, den zwei Unternehmen Ihres Arbeitsbereichs teilen, stimmt mit keinem von beiden überein, und ein Name auf der geprüften Liste von Namen, die auch ein anderes Unternehmen, einen Ort oder ein gewöhnliches Wort bezeichnen, wie Merck oder Continental, stimmt für sich allein nie überein. Der längste Name gewinnt, ein Beitrag, der Volkswagen Financial Services nennt, zählt also für dieses Unternehmen und nicht auch für Volkswagen. Ein Hashtag zählt als seine Wörter, #BritishAirways nennt also British Airways. Eine natürliche Person, die Ihr Arbeitsbereich beobachtet, wird ebenso über ihren ganzen Namen erkannt, wie die Nachrichtenbeobachtung ihn zuordnet, und Wörter, die ein Unternehmen und eine Person zugleich nennen, zählen für keines von beiden.

Was gespeichert wird

Für jeden zugeordneten Beitrag speichert Stonewake einen Schlüssel, die eigene Beitragsnummer der Quelle, die Plattform, den Link, das Veröffentlichungsdatum, die Sprache und die Einstufung, die die Quelle seinem Ton gibt, positiv, negativ oder neutral, oder keine. Name oder Handle eines Verfassers, Profilbild, Zahl der Follower, Titel oder Text eines Beitrags speichert Stonewake nicht. Sie werden verworfen, während der Beitrag gelesen wird. Ein Link auf einer sozialen Plattform wird nur in der Form gespeichert, die allein den Beitrag nennt. Ein Link, dessen Adresse die eigene Seite oder das Handle einer Person erkennen lässt, etwa ein Name mit @, eine Profilseite, Nutzerseite, Mitgliederseite oder Autorenseite, ein Kanal oder die eigene Subdomain eines Verfassers auf einer Blogplattform, wird nicht gespeichert, und der Beitrag antwortet mit url null und link_withheld true. Er bleibt über die Beitragsnummer der Quelle nachvollziehbar, aus der sein Schlüssel gebildet wird.

Eine beobachtete Person wird wie ein Unternehmen gelesen, ihre Lesung ist Kontext der Sorgfaltsprüfung, die Ihr Institut zu dieser Person durchführt, und nie ein Score der Person, und der Beitrag einer Privatperson wird wie jeder andere aufgeführt. Bei einem Einzelkaufmann, dem Geschäft einer natürlichen Person, werden die Beiträge ohne ihre Stimmung aufgeführt, und er hat keine Lesung. Keine Person und kein Einzelkaufmann wird je bewertet.

Tägliche Lesungen werden ein Jahr lang gespeichert, die Beiträge und ihre Zuordnungen ein Jahr und 30 Tage, damit jede gespeicherte Lesung auf ihre Beiträge zurückgeführt werden kann. Beiträge auf YouTube werden 30 Tage lang gespeichert. Danach werden sie gelöscht.

Die tägliche Lesung

Jedes Unternehmen hat eine Lesung pro Tag, in UTC, über die Beiträge, die es in den 30 Tagen bis zu diesem Tag genannt haben. Beiträge auf YouTube werden aufgeführt, aber nie gezählt, weil die Bedingungen von YouTube verbieten, seine Daten über Kanäle hinweg zusammenzuzählen. Eine Lesung zählt die Beiträge je Plattform in platform_counts und je Einstufung in positive, negative, neutral und unrated, und sie hat einen von drei Zuständen.

  • reading. Mindestens drei Beiträge mit Einstufung. sentiment_net ist die Zahl der positiven Beiträge abzüglich der negativen, geteilt durch die Beiträge mit Einstufung, von minus 1, alle negativ, bis plus 1, alle positiv.
  • too_little_coverage. Weniger als drei Beiträge mit Einstufung, während jeder der 30 Tage vollständig gelesen wurde. Es wird keine Stimmung gezeigt.
  • feed_gap. Der Tag selbst wurde nicht vollständig gelesen, oder es gibt weniger als drei Beiträge mit Einstufung, während einige der 30 Tage nicht vollständig gelesen wurden, sodass fehlende Beiträge nicht auszuschließen sind. Es wird keine Stimmung gezeigt.

Ein Tag ist vollständig gelesen, sobald ein vollständiger Abruf der Quelle mindestens sechs Stunden nach dem Ende des Tages lief und die Quelle dazwischen nicht meldete, dass sie das Sammeln eingestellt hatte. Die Tage eines Unternehmens zählen ab dem Tag, nachdem die Quelle den für das Unternehmen eingerichteten Alarm zum ersten Mal geliefert hat, ein Unternehmen ohne Alarm liest sich also nie als ruhig. Jede Lesung führt item_keys, die neuesten 100 der Beiträge, auf denen sie beruht, während items_window sie alle zählt, und gap_days sagt, wie viele ihrer 30 Tage nicht vollständig gelesen wurden. Die Lesungen Ihres Arbeitsbereichs beruhen nur auf Beiträgen, die für Ihren Arbeitsbereich zugeordnet wurden, ab dem Tag, nachdem er begann, dem Unternehmen zu folgen.

Die Lesung und die Kreditsicht

Die Lesung sozialer Medien ist Kontext neben der Kreditsicht. Sie fließt nicht in die Risikobewertung ein, die kein Modell, keine Nachrichten und keine sozialen Medien verwendet.

Routen

  • GET /v1/social/companies listet die Unternehmen aus Bestand und Beobachtungsliste Ihres Arbeitsbereichs und die Personen, die er beobachtet, mit node_type person, jedes mit seiner neuesten Lesung eines vollständig gelesenen Tages, seitenweise mit limit und offset. Ein Unternehmen ohne gespeicherte Lesung antwortet mit latest null, was nichts über seine Abdeckung sagt.
  • GET /v1/social/companies/{node_id} liefert die Lesungen eines Unternehmens, neueste zuerst, days davon (30, wenn nichts angegeben ist, höchstens 90), und seine neuesten 100 Beiträge der letzten 30 Tage, jeder mit item_key, platform, url, link_withheld, published_at, language, sentiment und matched_name.

Ein Schlüssel liest die Unternehmen aus dem Bestand seines eigenen Teams und die Unternehmen und Personen, die sein Arbeitsbereich beobachtet. Jedes andere Unternehmen antwortet mit 404, die Routen zeigen also nie, welchen Unternehmen ein anderer Arbeitsbereich folgt. Das Werkzeug für MCP company_social liest beide Routen.