API
摘要
CisionOne API 允许您将监测数据连接到其他内部数据集。
该 API 基于已经在账户中创建的提及流运行。所有 CisionOne API 调用都在
https://api.cision.one 下进行，所有响应以 JSON 和 CSV 格式返回。
客户将有选项返回以下数据：
1. 返回提及流的数据列表
2. 提及流的统计和指标摘要
3. 返回客户的提及流列表
Cision 的 API 如何工作？
我们遵守我们的合作关系，不通过 API 提供阅读量。
为了支持最广泛的商业智能 (BI) 工具，我们开发了我们的 API，以便您可以将数据从
Cision 提取到您的应用程序中。我们没有与其他工具的直接连接器，因此_从 Cision API
提取数据并将其导入您选择的系统的开发工作由您和您的开发人员承担。
API 提供哪些数据？
对于提及 （返回流的提及列表）：
1. 类型
2. 创建时间
3. 发布时间
4. 媒体
5. 标题
6. 作者
7. 是否已删除？
8. URL
9. 内部 Cision 链接
10. 来源
11. 来源时区
12. 地区
13. 语言代码
14. 情感情感判定
15. 关键词
16. 字数
17. 受众*
18. 广告价值
19. 影响评分
*由于我们与 SimilarWeb 的关系，我们无法在 API 中提供在线内容的单独受众数据。
Response Sample:
1 [
2 {
3 "id": 0,
4 "timestamp": 0,
5 "createdAt": "2019-08-24T14:15:22Z",
6 "publishedAt": "2019-08-24T14:15:22Z",
7 "medium": "string",
8 "title_summary": "string",
9 "author": "string",
10 "removed": true,
11 "url": "string",
12 "internalLink": "string",
13 "source": "string",
14 "timeZone": "string",
15 "locationCountry": "string",
16 "locationState": "string",
17 "locationCity": "string",
18 "languageCode": "string",
19 "wordCount": 0,
20 "sentiment": 0,
21 "keywordCounts": [],
22 "audience": 0,
23 "advertisingValue": 0,
24 "impactScore": 0
25 }
26 ]
27
对于提及流 (流的统计摘要)：
1. 日期范围
2. 流标签
3. 媒体类型
4. 广告价值
5. 按类型划分的受众
6. 情感聚合
响应示例：
1 {
2"streamId": 3349,
3 "streamLabel": "The Daily Show",
4 "before": "2023-06-14T02:34:56.000Z",
5 "after": "2023-06-14T02:34:56.000Z",
6 "media": [
7 "Online",
8 "Print",
9 "TV",
10 "Radio"
11 ],
12 "advertisingValues": [
13 {
14 "label": "TV",
15 "values": {
16 "count": 100,
17 "total": 100
18 }
19 },
20 {
21 "label": "Radio",
22 "values": {
23 "count": 100,
24 "total": 100
25 }
26 }
27 ],
28 "audiencesByType": [
29 {
30 "label": "TV",
31 "value": 100
32 },
33 {
34 "label": "Radio",
35 "value": 100
36 }
37 ],
38 "sentimentAggregation": [
39 {
40 "label": "Negative",
41 "values": {
42 "from": 0,
43 "to": 10,
44 "doc_count": 100
45 }
46 },
47 {
48 "label": "Trending Negative",
49 "values": {
50 "from": 0,
51 "to": 10,
52 "doc_count": 100
53 }
54 },
55 {
56 "label": "Balanced",
57 "values": {
58 "from": 0,
59 "to": 20,
60 "doc_count": 100
61 }
62 },
63 {
64 "label": "Trending Positive",
65 "values": {
66"from": 30,
67 "to": 40,
68 "doc_count": 100
69 }
70 },
71 {
72 "label": "Positive",
73 "values": {
74 "from": 40,
75 "to": 50,
76 "doc_count": 100
77 }
78 }
79 ]
80 }
81
}
对于您账户中的所有提及流：
您还可以选择获取您账户中所有提及流的摘要。如果您选择此选项，您将获得与您的提及
流相关的以下统计数据和指标。
• Id
• 标签
• 创建时间
• 更新时间
• 查询样式
• 关键词
• 排除的关键词
• 默认情感评分
• 已归档
• 杂志内容
• 在线内容
• 播客内容
• 广播内容
• 平面内容
• 社交内容
• 电视内容
响应示例：
GET /streams
GET /streams
1 [
2 {
3 "id": 3349,
4 "label": "The Daily Show",
5 "createdAt": "2023-06-14T02:34:56.000Z",
6 "updatedAt": "2023-06-14T02:34:56.000Z",
7 "queryStyle": "boolean",
8 "keywords": "foo",
9 "excludedKeywords": "bar",
10 "defaultSentimentRating": 0,
11 "archived": false,
12 "magazineContent": true,
13 "onlineContent": true,
14 "podcastContent": true,
15 "printContent": true,
16 "radioContent": true,
17 "socialContent": true,
18 "tvContent": true
19 }
20 ]
21
速率限制
对 API 的请求可能限制为每分钟 10 次请求。这受到您的 IP 地址和您使用的 API 密钥的
限制。超过此限制的请求可能会收到标准的 429（请求过多）HTTP 响应代码