Die CisionOne API ermöglicht es Ihnen, Ihre Monitoringdaten mit Ihren anderen internen Datensätzen zu verbinden.

Die API basiert auf Mention Streams die bereits in einem Konto erstellt wurden. Alle CisionOne API-Aufrufe werden unter https://api.cision.one durchgeführt und alle Antworten werden im JSON- und CSV-Format zurückgegeben.

Der Kunde hat die Möglichkeit, die folgenden Daten zurückzugeben:

Wir halten uns an unsere Partnerschaft und können keine Leserschaft über die API anbieten.

Um die größtmögliche Auswahl an Business Intelligence (BI) Tools zu unterstützen, haben wir unsere API entwickelt, damit Sie Daten von Cision in Ihre Apps ziehen können. Wir haben keine direkten Verbindungen zu anderen Tools mit unserer Cision API, daher liegt der Entwicklungsaufwand, um von der Cision API zu ziehen und diese Daten in Ihr gewähltes System zu importieren, bei Ihnen und Ihren Entwicklern.

Für eine Erwähnung (Gibt eine Liste von Mentions für einen Stream zurück):

* Aufgrund unserer Beziehung zu SimilarWeb können wir keine individuellen Publikumsdaten für Online-Inhalte in der API bereitstellen.

Antwortbeispiel:

[ { "id": 0, "timestamp": 0, "createdAt": "2019-08-24T14:15:22Z", "publishedAt": "2019-08-24T14:15:22Z", "medium": "string", "title_summary": "string", "author": "string", "removed": true, "url": "string", "internalLink": "string", "source": "string", "timeZone": "string", "locationCountry": "string", "locationState": "string", "locationCity": "string", "languageCode": "string", "wordCount": 0, "sentiment": 0, "keywordCounts": [], "audience": 0, "advertisingValue": 0, "impactScore": 0 } ]

Für ein Mention Stream (Eine Statistikenübersicht für einen Stream):

Beispiel für eine Antwort:

{ "streamId": 3349, "streamLabel": "The Daily Show", "before": "2023-06-14T02:34:56.000Z", "after": "2023-06-14T02:34:56.000Z", "media": [ "Online", "Print", "TV", "Radio" ], "advertisingValues": [ { "label": "TV", "values": { "count": 100, "total": 100 } }, { "label": "Radio", "values": { "count": 100, "total": 100 } } ], "audiencesByType": [ { "label": "TV", "value": 100 }, { "label": "Radio", "value": 100 } ], "sentimentAggregation": [ { "label": "Negative", "values": { "from": 0, "to": 10, "doc_count": 100 } }, { "label": "Trending Negative", "values": { "from": 0, "to": 10, "doc_count": 100 } }, { "label": "Balanced", "values": { "from": 0, "to": 20, "doc_count": 100 } }, { "label": "Trending Positive", "values": { "from": 30, "to": 40, "doc_count": 100 } }, { "label": "Positive", "values": { "from": 40, "to": 50, "doc_count": 100 } } ] }

Für alle Mention Streams in Ihrem Konto:

Sie können auch wählen, ob Sie eine Zusammenfassung aller Mention Streams in Ihrem Konto erhalten möchten. Wenn Sie dies wählen, erhalten Sie die folgenden Statistiken und Metriken zu Ihren Mention Streams.

Beispiel für eine Antwort:

GET /streams

[ { "id": 3349, "label": "The Daily Show", "createdAt": "2023-06-14T02:34:56.000Z", "updatedAt": "2023-06-14T02:34:56.000Z", "queryStyle": "boolean", "keywords": "foo", "excludedKeywords": "bar", "defaultSentimentRating": 0, "archived": false, "magazineContent": true, "onlineContent": true, "podcastContent": true, "printContent": true, "radioContent": true, "socialContent": true, "tvContent": true } ]

Anfragen an die API können auf 10 Anfragen pro Minute begrenzt sein. Es ist sowohl durch Ihre IP-Adresse als auch durch den API-Schlüssel, den Sie verwenden, begrenzt. Anfragen, die dieses Limit überschreiten, können den Standard-429 (Zu viele Anfragen) HTTP-Antwortcode erhalten.